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CAPÍTULO 1 


Construa sua primeira aplicação 


Com o passar do tempo os telefones celulares foram evoluindo, ganhando cada vez 
mais recursos e se tornando um item quase indispensável na vida das pessoas. Mas 
não foi apenas isso que mudou. Também houve uma mudança significativa para nós, 
os desenvolvedores de software. 

Antes, o mercado de desenvolvimento para celulares era praticamente restrito 
aos fabricantes e operadoras que controlavam a criação e inclusão dos aplicativos em 
seus aparelhos. A liberação, por parte dos fabricantes, de um kit de desenvolvimento 
de software (SDK) para suas plataformas e a criação de lojas para a distribuição de 
aplicativos viabilizou a abertura deste mercado para praticamente qualquer empresa 
ou desenvolvedor, criando assim novas oportunidades de negócio. 

A plataforma Android desfruta hoje de um papel de destaque no mercado, tanto 
pela quantidade significativa de dispositivos produzidos como também por ofere- 
cer uma API rica, disponibilizando fácil acesso a vários recursos de hardware, tais 
como Wi-Fi e GPS, além de boas ferramentas para o desenvolvedor. A facilidade 
de desenvolver utilizando uma linguagem de programação (Java) bastante dissemi- 
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nada, a simplicidade e baixo custo para a publicação de aplicativos na loja Google 
Play e a quantidade de dispositivos Android em uso no mundo só fazem aumentar 
a popularidade da plataforma. 

Segundo o relatório do International Data Corporation (IDC) publicado em 
maio de 2012, o Android possui 59% do mercado de smartphones e soma a quantia 
de 89,9 milhões de aparelhos distribuídos apenas no primeiro trimestre deste ano 
(2013), em todo o mundo. Em segundo lugar, aparece o iOS que é o sistema ope- 
racional do Apple iPhone. O gráfico 1.1 demonstra a participação no mercado dos 
principais sistemas operacionais e a quantidade de aparelhos distribuídos. 


Participação no mercado 


EE Android 

E ios 

® Simbian 

E BlackBerry 

EE Windows Phone 7 
E Outros 





Figura 1.1: Participação no mercado. Fonte: IDC 


O IDC também prevê que em 2016 o Android ainda possuirá a maior fatia do 
mercado, com 52,9%. A disputa pelo segundo lugar será acirrada entre iOS e Win- 
dows Phone 7. O gráfico 1.2 ilustra a previsão realizada pelo IDC. 
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Participação no mercado 


EE Android 

ios 

W BlackBerry 

EE Windows Phone 7 
E Outros 





Figura 1.2: Previsão do mercado para 2016. Fonte: IDC 


Já no mercado de tablets, o iPad detém o trono com 68% enquanto o Google 
aposta em seu primeiro tablet, o Nexus 7 ao preço 199 dólares, para ganhar terreno 
tentando repetir o sucesso do Amazon Kindle Fire que também utiliza Android. 


1.1 CONHEÇA O ANDROID 


Desenvolvido especialmente para dispositivos móveis como aparelhos celulares e ta- 
blets, o Android é uma plataforma composta de um sistema operacional, middlewa- 
res e um conjunto de aplicativos principais como os Contatos, Navegador de Internet 
e o Telefone propriamente dito. Além disso, existe o Android SDK que é um con- 
junto de ferramentas e APIs para o desenvolvimento de aplicativos para a plataforma, 
utilizando a linguagem Java. No decorrer do livro, vamos abordar em detalhes os 
componentes existentes no Android além de mostrar como integrá-los para criar 
aplicações ricas em funcionalidades e com uma usabilidade agradável. 

Baseado no Linux, o sistema operacional Android teve seu desenvolvimento 
iniciado em 2003 pela empresa Android Inc. Em 2005, a empresa foi adquirida 
pelo Google, que hoje lidera o desenvolvimento do Android. Um marco impor- 
tante desta trajetória aconteceu em 2007, com a criação da Open Handset Alliance 
(http://www.openhandsetalliance.com/) , que é uma associação de empresas de soft- 
ware, hardware e telecomunicações, cuja missão é desenvolver uma plataforma para 
dispositivos móveis que seja completa, aberta e gratuita. Também em 2007 ocorreu 
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o lançamento da versão beta do primeiro SDK para Android! Após diversas versões 
e melhorias, em junho de 2012 foi anunciado o Android 4.1, codinome Jelly Bean. 





UM POUCO MAIS DE HISTÓRIA 


Quer saber mais sobre a história do Android, suas versões, e evolu- 
ções? Então visite http://www.xcubelabs.com/the-android-story.php e 
http://www.theverge.com/2011/12/7/2585779/android-history 











Nesta última versão, a interface gráfica esta mais refinada e evoluída, novas fun- 
cionalidades como widgets redimensionáveis, possibilidade de usar pastas para orga- 
nizar as áreas de trabalho e novas ações que podem ser executadas sem desbloquear 
a tela do aparelho foram adicionadas, incluindo acessar rapidamente a câmera para 
capturar aquele flagra. E por falar nisto, o aplicativo da câmera recebeu atenção es- 
pecial e agora conta com fotos panorâmicas que podem ser tiradas simplesmente 
movendo o aparelho de um lado a outro e mais ainda, conta também com um pode- 
roso editor de imagens, dentre outras várias funcionalidades. 

Para facilitar a comunicação, agora é possível conectar dois dispositivos dire- 
tamente através do Wi-Fi Direct e a introdução do Bluetooth HDP (Health Device 
Profile) permite a conexão entre o seu aparelho e dispositivos voltados para a saúde 
e bem-estar. Já o novo recurso Android Beam, utilizando tecnologia NFC (Near Field 
Communication), permite compartilhar aplicativos, contatos, vídeos e músicas, livre 
de qualquer tipo configuração, com apenas um toque. Outra facilidade adicionada 
foi o desbloqueio do aparelho através do reconhecimento da face do usuário. Em 
uma tela de configuração, o usuário previamente registra o seu rosto e depois, para 
desbloquear o aparelho, basta posicionar a câmera frontal que fará o reconhecimento 
e liberará o acesso. Muito legal, não é mesmo? 





ANDROID É CÓDIGO ABERTO! 


O Android é código aberto e distribuído sob licença Apache 2.0, o 
que quer dizer que você tem acesso aos códigos-fonte e também pode 
contribuir com o projeto! Saiba mais em http://source.android.com 
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1.2 CONFIGURE O AMBIENTE PARA DESENVOLVIMENTO 


Antes de criar a nossa primeira aplicação Android, é necessário baixar e instalar o 
Android SDK que está disponível em http://developer.android.com/sdk. Escolha o 
pacote mais adequado de acordo com o seu sistema operacional, faça o download e 
instale. Um detalhe importante é que o Java Development Kit (JDK) é um requisito 
necessário, portanto, se você ainda não o possui, faça o download e siga as instru- 
ções de instalação em http://www.oracle.com/technetwork/java/javase/downloads/ 
index.html. 


[RON Gandros 50K | Andie’ De | 


| = CD semper anca com srs 1 CERTOS 
] 
E) Developers Design Develop Distribute N 
| Android Training API Guides Reference Tools 
Developer Tools Get the Android SDK 





Download 

The Android SDK provides you the API libraries and 
developer tools necessary to build, test, and debug 
apps for Android. 


Download the SDK for Mac 


Installing the 
SDK 


Exploring the SOK 
NDK 


Workflow 





Tools Help 
Revisions 
Extras 
Samples 


ADK 


Figura 1.3: Pagina de download do Android SDK 


Neste momento o que temos instalado são apenas as ferramentas que fazem parte 
do Android SDK. Precisaremos agora selecionar e baixar as APIs para as quais pre- 
tendemos desenvolver nossas aplicações. Por enquanto, utilizaremos a versão 2.3.3 
(API 10) e futuramente vamos usar recursos novos da plataforma e faremos a tran- 
sição entre as versões. 

Abra o Android SDK Manager. O aplicativo buscará informações sobre as ver- 
sões disponíveis e trará selecionada a versão mais recente. Não ceda à tentação de 
baixar tudo o que está disponível, pois o tempo de download provavelmente demo- 
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raria mais do que o tempo de leitura deste livro. Desmarque o que vier selecionado e 
escolha apenas a opção SDK Platformdoitem Android 2.3.3,como demons- 
tra a imagem abaixo: 












































ANA Android SDK Manager 
= 
SDK Path: sers/joao/Dev/android-sdk-ma: x86 
Packages 
Rev. Status 
O TZ] Android 2.3.3 (API 10) 
M ‘W SDK Platform 2 ; Not installed 
oO FA Samples for SDK 1 Not installed 
‘ty. Google APIs 2 = § Not installed | 
| Intel Atom x86 System Image 1 + Not installed 
‘Dual Screen APIs 1 $ Not installed 
ty Real3D 2 § Not installed 
if ADMIRAL 5 + Not installed 
Ep ATRIX2 2 + Not instalted 
ty. Bionic 2 Ẹ Not installed 
iy. defy+ 1º § Not installed 
18 Oroid4 2 A Not installed 
EL DroidRAZR 5 § Not installed 
iğ MotorolaPro+ 2 $ Not installed 
fy. MT870 2 — Ẹ Not installed 
ip MT917 1 $ Not installed 
‘fy. PHOTON 1 § Not installed 
fy XT882 2  Ẹ Not installed | 
RL XT928 3 Not installed 
‘ty Sony Xperia Extensions EDK 2.0 2 4 Not installed 
Show: (M Updates/New [M Installed [ Obsolete Select New or Updates | Install 1 package... 
Sort by: (*) API level _) Repository Deselect All Déléto packages 


Done loading packages. 





Figura 1.4: SDK Manager 


Também precisaremos de uma IDE para auxiliar o desenvolvimento. Ao longo 
deste livro utilizaremos o Eclipse com um plugin específico que auxilia no desenvol- 
vimento para Android. O Eclipse possui diferentes distribuições, sendo que algumas 
são indicadas para desenvolvimento de aplicações para Android. São elas: 


1) Eclipse Classic 
2) Eclipse IDE for Java Developers 
3) Eclipse IDE for Java EE Developers 


Essas versões se encontram disponíveis para download em http://www.eclipse. 
org/downloads. 
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Se você ainda não tem uma preferência por alguma distribuição, uma boa escolha 


é a Eclipse Classic. A instalação da IDE é bastante simples, bastando descompactá- 


la em um diretório de sua preferência. Já estamos quase prontos! Partiremos agora 


para a instalação do plugin ADT (Android Development Tools) que fornecerá todas 


as facilidades para a criação e codificação de um projeto Android no Eclipse. 


A instalação do plugin é feita a partir do gerenciador de atualizações do Eclipse. 


Portanto, inicie a IDE e siga as instruções a seguir: 


1) 
2) 
3) 


4) 


5) 


6) 
7) 


8) 


Vá até o menu Help > Install New Software... 
Clique no botão add, para adicionar um novo repositório 


Na janela que será apresentada, escolha um nome para o repositório, ADT Plu- 
gin por exemplo, e informe a seguinte URL https://dl-ssl.google.com/android/ 
eclipse/ 


Clique em OK para finalizar 


Uma listagem será apresentada, marque a opção Developer Tools para instalar 
todos os itens necessários 


Clique em Next para prosseguir com a instalação 
Leia e aceite os termos das licenças e clique em finish 


Reinicie o Eclipse conforme sugerido para concluir a instalação 


(5 Welcome | 
(2) Help Contents 
2 Search 


Dynamic Help 


Key Assist... ORL 
Tips and Tricks... 
Cheat Sheets... 


Check for Updates 
Install New Software... 


Figura 1.5: Menu Help 
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Es install 
Available Software 
Select a site or enter the location of a site. 
Work with: | type or select a site Tw) [ ada. | 
Find more software by working with the “Available Software Sites” preferences. 
| type filter text = 
Name Version 
O (DThereisnosi, E io n ue ni 











Location: http:// 





| SelectAll | | E (2) : 


[V Show only the latest versions of available software 
IV Group items by category 


L Hide items that are already installed 


What is already installed? 
\_| Show only software applicable to target environment 


If Contact all update sites during install to find required software 





D <Back a po | Cancel | minish 


Figura 1.6: Adicionando um novo repositório 
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Available Software 
Check the items that you wish to install. m 
Work with" | ADT Plugin — https:/ /dl-ssl.google.com/android/eclipse/ IE | | Add... 1 
Find more software by working with the “Available Software Sites" preferences. 
| type Alter test 
Name = Version 
(Vill Developer Tools 
Q Android DDMS 20.0.2.v201207191942-407447 
m G Android Development Tools 20.0.2.v201207191942-407447 
vw WE Android Hierarchy Viewer 20.0.2.¥201207191942-407447 
w {Android Traceview 20.0.2.v201207191942-407447 
M Tracer for OpenGL ES 20.0.2.v201207191942-407447 
C] > 00 NDK Plugins 
| SelectAll | | Deselect All | 5 items selected 
Details 
Show only the latest versions of available software | Hide items that are already installed 
Group items by category What is already installed? 


| Show only software applicable to target environment 
[ Contact all update sites during install to find required software 








D Bark Next | Cancel | Finish 


| hl ae SS a ke. 


Figura 1.7: Escolhendo o que sera instalado 
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Review Licenses 


Licenses must be reviewed and accepted before the software can be installed. 





Licenses: License text: 





kpacr ense Apache License 
E Note; jcommon-1.0.12.jar is under the BS Version 2.0, january 2004 
Note: kxmiZ-2.3.0.jar is under the BSD lic http://www.apache.org/licenses / 


TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBLITION 
1. Definitions. 


“License” shall mean the terms and conditions for use, reproduction, 
and distribution as defined by Sections 1 through 9 of this document. 


“Licensor” shall mean the copyright owner or entity authorized by 
the copyright owner that is granting the License. 


“Legal Entity” shall mean the union of the acting entity and all 
other entities that control, are controlled by, or are under common 
control with that entity. For the purposes of this definition, 
“control” means (i) the power, direct or indirect, to cause the 
direction or management of such entity, whether by contract or 
otherwise, or (ii) ownership of fifty percent (50%) or more of the 
outstanding shares, or (iii) beneficial ownership of such entity. 


“You” (or “Your” shall mean an individual or Legal Entity 
exercising permissions granted by this License. 


“Source” form shall mean the preferred form for making modifications, 
including but not limited to software source code, documentation 
source, and configuration files. 


vei l accept the terms of the license agreements 


Ii Ido not accept the terms of the license agreements 





You will need to restart Eclipse SDK for the changes to take effect. Would you like 
to restart now? 





Figura 1.9: Reiniciando o Eclipse 


Após o término da instalação, é necessário configurar o plugin ADT para en- 
contrar o Android SDK instalado previamente. Para isto, vá até o menu Window 
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> Preferences (para quem usa Mac: Eclipse > Preferences), no lado es- 
querdo selecione o item Android. Por fim, no painel que será apresentado informe 
o local em que o Android SDK está instalado. 


a R Preferences 








type filier text Android -Y 


® General 
Android Preferences 

Ant 

+ Help 

Pinstall/Update Note: The list of SDK Targets below is only reloaded once you hit ‘Apply’ or ‘OK’. 

> java 

® Plug-in Development (OBS Mary / 

+ Run/Debug No cargel 

+ Team 

» XML 





SDK Location: | /Users/joao/Dev/android-sdk-mac_x86 [ Browse... | 


[ Restore Defauts | | Aow 








D [ocan = 
nae eee E à SE NA 





Figura 1.10: Configurando o SDK 


1.3 ESCREVA O HELLO WORLD! 


Agora que temos o ambiente de desenvolvimento preparado, estamos prontos 
para escrever nossa primeira aplicação Android! Como uma primeira experiên- 
cia em uma nova plataforma, vamos desenvolver um clássico Hello World. No 
Eclipse, devemos criar um novo projeto Android, através do menu File > New 
> Project.. .. Na nova janela que será apresentada, selecione a opção Android 
Application Project, como mostra a figura 1:11. 
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ANA New 


Select a wizard 





Create an Android Application Project 


Wizards: 


aptent 





type 
| 3 Java Project from Existing Ant Buildfile 
je Plug-in Project 
# © General 
¥ E Android 
EÉ Android Activity 
E] 





G Android Icon Set 

[i] Android Object 

ES Android Project from Existing Code 
ES Android Sample Project 

JË Android Test Project 

ic Android XML File 

laf Android XML Layout File 

lc Android XML Values File 





Figura 1.11: Criando um novo projeto Android 


Na tela seguinte, escolha um nome para o seu projeto, no nosso caso, vamos 
chamar de Hel loAndroid. É importante escolher o nome da aplicação e também 
do pacote com cautela, pois esses dois nomes serão utilizados para identificar sua 
aplicação quando for feita uma publicação no Google Play. Para nossa aplicação, 
escolhemos o nome HelloAndroid (no caso, mesmo nome do projeto) e o pacote 
br.com.casadocodigo.helloandroid. 

A opção Build SDK permite selecionar qual é a versão do Android que será 
utilizada por nossa aplicação. Como apenas a versão 2.3.3 (API 10) foi instalada, esta 
é a única opção disponível no momento. A opção Minimum Required SDK indica 
qual é a versão mínima exigida para executar o aplicativo. Vamos deixar como está. 
A imagem 1.12 mostra como ficou a configuração do projeto. 
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22.2 New Android App 





New Android Application 


Creates a new Android Application 


Application Name: © HelloAndroid| 





Project Name: B| HelloAndroid f = 


Package Name: B| br.com.casadocodigo.helloandroid z 





Build SDK: & | Android 2.3.3 (API 10) 








Minimum Required SDK: 2 | API 8: Android 2.2 (Froyo) 





M Create custom launcher icon 
\_| Mark this project as a library 
M Create Project in Workspace 


Location: sers joad] Dev/workspace_boakè j HelloAniaruid Draws, 


hf The application name is shown in the Play Store, as well as in the Manage Application list in Settings, 





| <Back | [Ns] | 





Figura 1.12: Escolhendo um nome e pacote para a aplicação 


Prossiga para o próximo passo clicando em Next. Uma tela como mostra a 
figura 1.13 será apresentada para que você possa customizar o ícone do aplicativo se 
desejar. Selecione novamente a opção Next. A próxima tela sugere a criação de 
uma BlankActivity, conforme demonstra a imagem 1.14. Nenhuma alteração é 
necessária nesta tela. 


13 


13. Escreva o Hello World! Casa do Código 


Configure Launcher Icon 
Configure the attributes of the icon set 
Preview: 
z e 


M Trim Surrounding Blank Space A 
Additional Padding: (hdi 


— 10% 
Foreground Scaling: (Crop | Center | | 3 j 
Shape | None | square [rae] Dg 














a e 
ss 








(2) | <Back | [Next] | cancel | | Finisty 








Figura 1.13: Personalizando o ícone da aplicação 
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Create Activity 


Select whether to create an activity, and if so, what kind of activity. © 


vw Create Activity 


BlankActivity 
MasterDetailFlow 


New Android Apa 

















New Blank Activity 


Creates a new blank activity, with optional inner navigation. 




















Figura 1.14: Criando uma Activity 


Ao selecionar Next, vamos para o último passo, que consiste em definir o nome 
da Activity e também do layout que será utilizado por ela. Mantenha as informa- 


ções da forma que estão, assim como mostra a figura 1.15. Para finalizar a criação do 
projeto, clique em Finish. 
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Ba New Andraid App 





New Blank Activity 


Creates a new blank activity, with optional inner navigation. 


Activity Name ©) MainActivity 
Layout Name ©) activity main 


Navigation Type O | None 





Hierarchical Parent O 


Title © MainActivity 


Pi The name of the activity class to create 














Figura 1.15: Definindo o nome da Activity 


(2) <Back | at | Cancel | [m 





Com a ajuda do ADT, um novo projeto foi criado com as configurações escolhi- 
das. Esse projeto já está com tudo que é necessário para ser executado. Entraremos 
em mais detalhes depois, agora o que queremos ver é a aplicação funcionando, certo? 
Selecione o menu Run > Run, uma caixa de diálogo Run as vai aparecer. Escolha 


a opção Android Application e clique em OK, como na figura 1.16: 
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%, Debug F11 
Run History > 
Run As b 
Run Configurations... 
Debug History b 
Debug As + 
Debug Configurations... 

Toggle Breakpoint HE 

Taygle Line Breakpoint 

Toggle Method Breakpoint 


Toggle Watchpoint 
X Skip All Breakpoints 

Remove All Breakpoints 
40 Add Java Exception Breakpoint... 
(3 Add Class Load Breakpoint... 


fy All References. 
All Instances... WN 
Instance Count... 
Watch 
Inspect jë | 
Display TEAN 
Execute 
Force Return H 


Step Inta Selection 


& External Tools » 





Figura 1.16: Menu Run 


Ops! Algum problema aconteceu. Surgiu uma caixa de diálogo dizendo que não 
temos nenhum dispositivo compatível instalado. 


perc Android -AVD Error 





No compatible targets were found. Do you wish to a add new Android Virtual 
2 Device? 





Figura 1.17: Nenhum dispositivo virtual configurado 


De fato, nao criamos nenhum dispositivo virtual (Android Virtual Device, AVD) 
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para rodar nossa aplicação! Vamos aproveitar e fazer isso agora, respondendo Yes à 
pergunta se queremos criar um dispositivo. A caixa de diálogo é fechada e o aplica- 
tivo Android Virtual Device Manager será iniciado. 

Na tela apresentada, clique em New para criar um novo dispositivo virtual. Faça 
a configuração conforme na figura 1.18. 








LANN Create new Android Virtual Device (AVD) 
Name Phonel 
Target Android 2,3.3 — API Level 10 
CPU/ABI 
SD Card 
te) Size 32 ME 
File 
Snapshot a 
L- Enabled 
Skin 
(©) Built-in Default (WVGA800) 
Resolution x 
Hardware 
Property Value New 
Abstracted LCD density 240 
Max VM application hea 24 
Device ram size 256 
Cancel | Creare AVD: | 





Figura 1.18: Criando um novo dispositivo virtual 


Agora é só executar o projeto novamente. Como ja existe um AVD criado para 
a plataforma alvo do nosso aplicativo, o emulador será iniciado automaticamente. 
A inicialização do emulador pode demorar um pouco, aproveite para buscar uma 
xícara de café. Quando retornar, o aplicativo já deve ter sido iniciado no emulador e 
uma tela semelhante a esta será mostrada: 
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æ ul Ø 6:49 


Hello world! 


Figura 1.19: Hello Android! 





DICA 


Não é necessário reiniciar o emulador para testar uma nova versão, 
então a dica é mantê-lo sempre aberto para economizar o tempo de ini- 


cialização. 











1.4 CONHEÇA A ESTRUTURA DO PROJETO 


Já temos a primeira versão do nosso Hello World. É bem verdade que ainda não 
fizemos nenhuma codificação, então vamos analisar a estrutura do projeto e tudo 
aquilo que foi gerado automaticamente para que essa mágica acontecesse. Na figura 
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1.20, podemos identificar cinco pastas principais ( src, gen, assets, bin, libs 


e res) além de uma referência para a biblioteca Android que está sendo utilizada: 


1) 


2) 


3) 
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[E Package Explorer 52 Sar 


y ES HelloAndroid 
T src 
Y 83 br.com.casadocodigo.helloandroid 
P [D] MainActivity.java 
¥ EB gen |Gonerated Java Fil 
© H} br.com.casadocodigo.helloandroid 
> [J] BuildConfig.java 
® [D Rjava 
P = Android 2.3.3 
b = Android Dependencies 
Eb assets 
P És bin 
+ £ libs 
v Gores 
+ (= drawable-hdpi 
> = drawable-ldpi 
+ (& drawable-mdpi 
> (& drawable-xhdpi 
© (= layout 
|| activity main.xml 
P => menu 
¥ (values 
| dimens.xml 
a strings.xml 
la styles.xml 
> (& values-large 
al AndroidManifest.xml 
GÀ ic launcher-web.png 
[E proguard-project.txt 
E] project.properties 




















Figura 1.20: Estrutura do projeto 


src - pasta dedicada ao armazenamentos dos códigos-fonte do projeto e será 
onde colocaremos as classes Java que criaremos em nossa aplicação. Repare que 
já existe uma MainActivity. java que foi criada automaticamente quando 
criamos o projeto; 


res - dedicado ao armazenamento de recursos (arquivos de layout, imagens, ani- 
mações e xml contendo valores como strings, arrays etc.), acessíveis através 
da classe R; 


assets - diretório para o armazenamento de arquivos diversos utilizados por 
sua aplicação. Diferentemente dos recursos armazenados na pasta res, estes são 
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acessíveis apenas programaticamente; 


4) gen - armazena códigos gerados automaticamente pelo plugin, como a classe R 
que mantém referências para diversos tipos de recursos utilizados na aplicação; 


5) libs - pasta para armazenar bibliotecas de terceiros que serão utilizadas pela 
aplicação; 


6) bin - local utilizado pelos processos de compilação e empacotamento para man- 
ter arquivos temporários e códigos compilados. 


No diretório raiz do projeto também existem alguns arquivos, sendo um deles, 
O AndroidManifest .xm1, obrigatório para toda aplicação Android. Esse arquivo 
contém informações essenciais sobre a sua aplicação e sobre o que é necessário para 
executá-la, incluindo a versão mínima do Android. O nome do pacote escolhido 
durante a criação do projeto, por exemplo, é armazenado lá para servir como iden- 
tificador único da sua aplicação. 

O manifesto também descreve os componentes (activities, services, content pro- 
viders e broadcast receivers) que fazem parte da aplicação, possibilitando que o sis- 
tema operacional Android seja capaz de identificá-los e determinar quando serão 
executados. Durante o livro, vamos aprender como trabalhar com esses diferentes 





componentes. No código a seguir,a activity MainActivity é quem representa 
o componente que é iniciado quando executamos a aplicação. 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="br.com.casadocodigo.helloandroid" 
android: versionCode="1" 
android: versionName="1.0" > 


<uses-sdk 
android:minSdkVersion="8" 
android: targetSdkVersion="15" /> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name" 
android: theme="@style/AppTheme" > 
<activity 
android:name=".MainActivity" 
android:label="QOstring/title activity main" > 
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<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


As activities são componentes da plataforma Android, capazes de apresentar uma 
tela para interagir com os usuários. Através delas podemos tirar uma foto, enviar 
um email, visualizar uma imagem e navegar na Internet. Geralmente uma aplica- 
ção é composta por várias activities, sendo uma delas a activity principal que é 
executada quando a iniciamos. O código a seguir demonstra a atividade principal 
(MainActivity. java) do nosso projeto HelloWorld que foi criada automatica- 
mente pelo ADT plugin: 


public class MainActivity extends Activity { 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


@Override 
public boolean onCreateOptionsMenu(Menu menu) { 
getMenuInflater() .inflate(R.menu.activity_main, menu); 


return true; 


Para criar uma atividade, basta fazer com que nossa classe estenda a 
classe Activity do Android, como pode ser visto na linha 1. Ja na li- 
nha 6, passamos para o método setContentView o identificador do layout, 
R.layout.activity main, que deve ser carregado para construir a interface grá- 
fica da nossa Activity. É bastante comum e também recomendado que as infor- 
mações referentes a layouts e interfaces gráficas estejam externalizadas em arquivos 
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XML, separados do código da aplicação. Essas e outras boas práticas nós aprendere- 


mos no decorrer do livro. 


Vamos prosseguir verificando o arquivo activity main.xml, que se encon- 





tra no diretório res/layout/ do projeto. 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 


android: layout_width="match_parent" 


android: layout_height="match_parent" > 


<TextView 


android: 
android: 
android: 
android: 


android 


android: 


layout width="wrap content" 
layout height="wrap. content" 
layout centerHorizontal="true" 
layout centerVertical="true" 


:padding="0dimen/padding medium" 


text="Ostring/hello world" 


tools:context=".MainActivity" /> 


16 </RelativeLayout> 





RECURSOS GRÁFICOS DO ADT 


Quando abrimos um arquivo de layout no Eclipse com o ADT ins- 
talado, ele é apresentado em um visualizador de layouts (aba Graphical 
Layout), no qual é possível verificar como o layout está ficando além de 
contar com opções para configurar diversos atributos. Também é possí- 
vel utilizar esse recurso para adicionar elementos de layout e de entrada 
de dados. Para ver o XML resultante selecione a outra aba que possui o 
nome do arquivo. Para conhecer mais sobre os recursos disponíveis no 
ADT visite http://developer.android.com/tools/help/adt.html. 











Neste arquivo de definição de layout temos dois elementos declarados, o 


RelativeLayout eo TextView, com seus respectivos atributos. Como o nome 


sugere, o RelativeLayout (linha1) é um elemento para organização do layout da 


tela, permitindo configurar a sua altura e largura. 
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Já o TextView é um widget utilizado para apresentar na tela uma informa- 
ção textual. O valor a ser exibido por este elemento está especificado através do 
atributo text. Repare que na linha 13 o valor que TextView deve exibir é 





Gstring/hello world. Aqui temos novamente um caso no qual a externaliza- 
ção é recomendada principalmente para facilitar a internacionalização da aplicação, 
suportando vários idiomas diferentes e para até mesmo reaproveitar mensagens. 

O valor que será utilizado no TextView sera na verdade o con- 
teúdo da string que possui o identificador hello world. No arquivo 
res/values/strings.xml é possível observar como isso foi definido: 


<resources> 

<string name="app name">HelloAndroid</string> 

<string name="hello_world">Hello world!</string> 

<string name="menu_settings">Settings</string> 

<string name="title_activity_main">MainActivity</string> 
</resources> 


Na linha 3, declaramos uma string com o nome hello world cujo valor é 
“Hello World!” Por convenção, o arquivo strings. xml é onde definimos recursos 
do tipo string, ou seja, textos que queremos exibir de alguma maneira em nossa 
aplicação. Para finalizar, altere o valor da string hello world para "Hello 





Android!" e execute a aplicação novamente. O resultado desta alteração pode ser 
visto na imagem 1.21 





Dica: ACESSANDO O AVD MANAGER E SDK MANAGER PELO 
ECLIPSE 


Após a instalação e configuração do ADT, através do menu Window 
é possível fazer um acesso rápido ao AVD Manager e SDK Manager para 
baixar novas versões do Android e também criar novos dispositivos vir- 
tuais! 
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'MainActivity 





Hello Android! 


Figura 1.21: Hello Android 


1.5 HELLO WORLD 2.0 


Para melhorar a nossa aplicação, iremos incluir mais algumas coisas e aproveitar 
para entender alguns pontos fundamentais do desenvolvimento Android. Em nossa 
versão melhorada do Hello World, o usuário informará seu nome em uma caixa de 
texto, pressionará um botão e a aplicação apresentará uma saudação personalizada. 
A aplicação ficará com a seguinte aparência: 
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MainActivity 
Informe seu nome 


| Surpreenda-me 
Estão = sê 


Figura 1.22: Versão melhorada 


Podemos modificar o layout activity main.xml já existente, para incluir 





um campo onde o usuário irá informar o seu nome. Esse campo pode ser criado 





utilizando um widget do tipo Edit Text, no qual podemos inclusive indicar que o 
mesmo receberá o foco da aplicação: 


<EditText 
android: id="0+id/nomeEditText" 
android: layout width="match parent" 
android:layout height="wrap content" 
android: inputType="textPersonName" > 


<requestFocus /> 
</EditText> 


Além disso, também teremos que incluir um botão, através do widget Button: 


<Button 
android: id="0+id/saudacaoButton" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android:layout gravity="center" 
android:text="0string/surpreenda me" /> 


Neste momento, para facilitar a criação do layout com estes novos elementos, ire- 
mos substituir o RelativeLayout por um LinearLayout que permite colocar 
um widget por linha. Com estes novos elementos podemos montar a tela completa 
do novo Hello World que ficará como o código a seguir: 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
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android: layout width="match parent" 


android:layout height="match parent" 


android:orientation="vertical" > 


<TextView 
android 


android: 
android: 


<EditText 


android: 
android: 
android: 
android: 


“layout width="match parent" 


layout height="wrap content" 
text="Ostring/titulo" /> 


id="@+id/nomeEditText" 
layout_width="match_parent" 
layout_height="wrap_content" 
inputType="textPersonName" > 


<requestFocus /> 


</EditText> 


<Button 


android: 
android: 


android 


android: 


android 


<TextView 


android: 
android: 


android 


</LinearLayout> 


id="@+id/saudacaoButton" 


layout width="wrap content" 


“layout height="wrap content" 


layout gravity="center" 


:text="Qstring/surpreenda_me" /> 


id="0+id/saudacaoTextView" 
layout width="match parent" 


:layout height="wrap content" /> 


Nos itens recém adicionados, repare que colocamos um atributo android 


rid 


que é importante, pois posteriormente precisaremos referenciar e manipular es- 


ses componentes visuais. Também é necessário criar as strings que serão uti- 


lizadas como o título, o rótulo do botão e também uma saudação. Nosso arquivo 


strings.xml deverá ficar assim: 


<resources> 


<string name 


="app name">HelloAndroid</string> 


<string name="hello_world">Hello Android!</string> 
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<string name="menu_settings">Settings</string> 
<string name="title_activity_main">MainActivity</string> 
<string name="titulo">Informe seu nome</string> 
<string name="surpreenda_me">Surpreenda-me</string> 
<string name="saudacao">0lá</string> 

</resources> 


Ao executarmos a aplicação novamente já perceberemos as mudanças realizadas 
e o resultado será igual à imagem 1.22. Como ainda não programamos nenhuma 
ação para o botão disponível na tela, ao pressioná-lo, nada de diferente acontece. 

Para obter o resultado esperado, criaremos um método na nossa 
MainActivity que responderá a esta ação apresentando ao usuário uma 
saudação personalizada. Então vamos configurar nosso botão para que quando ele 


seja pressionado um método seja invocado. Para isso, utilizaremos o onClick: 


<Button 
android: id="0+id/saudacaoButton" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android:layout gravity="center" 
android: text="@string/surpreenda_me" 
android: onClick="surpreenderUsuario"/> 


Informamos que o método a ser acionado após o clique do botão é o 
surpreenderUsuario, através da propriedade onclick. Este método deve ne- 
cessariamente ser público e receber como parâmetro um objeto do tipo View que é 
uma referência do botão que foi pressionado: 


public void surpreenderUsuario (View v){ 


Nesse método, precisamos modificar o conteúdo do widget 





saudacaoTextView para que ele mostre o conteúdo informado no Edit Text. 
Para isso, vamos precisar que a classe MainActivity possua referência para esses 





elementos. Vamos começar declarando atributos parao EditText eo TextView: 


public class HelloAndroidActivity extends Activity { 
private EditText nomeEditText; 
private TextView saudacaoTextView; 
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@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.main); 


public void surpreenderUsuario(View v) { 5 


//demais códigos existentes 


No método onCreate, temos que conseguir as referências para os componen- 
tes. Podemos fazer isso através do método findViewById: 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
setContentView(R.layout.activity_main) ; 
this.nomeEditText = (EditText) findViewById(R.id.nomeEditText) ; 
this.saudacaoTextView = (TextView) 
findViewById(R.id.saudacaoTextView) ; 


Agora que ja temos as referéncias para os objetos, podemos obter o valor di- 





gitado pelo usuário, que está armazenado no EditText e atribui-lo como con- 
teúdo do TextView. Para realizar esta operação, basta implementar o método 


surpreenderUsuario dessa forma: 


public void surpreenderUsuario(View v) 1 
Editable texto = this.nomeEditText.getText (); 
this.saudacaoTextView.setText(texto); 


Por fim, vamos adicionar a string saudacao, que está definida no arquivo 
strings.xml, para compor a mensagem final para o usuário. Para isso, basta 


recuperá-la através do método getResources: 


String saudacao = getResources() .getString(R.string.saudacao); 


Podemos fazer a leitura dessa saudação no método onCreate e usar a mensa- 
gem na nossa implementação de surpreenderUsuario, como no código a seguir: 
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public class MainActivity extends Activity { 


private EditText nomeEditText; 
private TextView saudacaoTextView; 
private String saudacao; 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 
this.nomeEditText = (EditText) findViewById(R.id.nomeEditText); 
this.saudacaoTextView = 
(TextView) findViewById(R.id.saudacaoTextView) ; 
this.saudacao = getResources().getString(R.string.saudacao) ; 


public void surpreenderUsuario(View v) { 
Editable texto = this.nomeEditText.getText (); 
String msg = saudacao + " " + texto.toString() ; 
this.saudacaoTextView.setText (msg) ; 


//demais códigos existentes 


Agora, podemos executar essa aplicação, que será similar à figura 1.23 


ull & 8h20 


MainActivity N 
Informe seu nome 





Surpreenda-me 


Olá Leitor 


Figura 1.23: HelloWorld 2.0 
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1.6 CONCLUSÃO 


Neste capítulo aprendemos um pouco da história do Android e suas versões e ti- 
vemos o primeiro contato com o Android SDK e com a Eclipse IDE. Criamos um 
projeto de exemplo, buscamos entender seus detalhes e organização, além de fazer 
modificações no código e layout para termos nossa primeira experiência. No capí- 
tulo seguinte abordaremos itens essenciais para o desenvolvimento Android. 
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CAPÍTULO 2 


Entenda o funcionamento do 
Android 


Após desenvolver nosso primeiro projeto na plataforma Android, é importante co- 
nhecer um pouco mais dos elementos que a compõe e também do funcionamento 
básico do Android. Este capítulo apresenta como as aplicações são geradas e execu- 
tadas, quais são os componentes de aplicação existentes na plataforma, como eles se 
comunicam e também como os elementos de interface gráfica estão organizados. 


2.1 A EXECUÇÃO DAS APLICAÇÕES 


As aplicações implementadas utilizando a linguagem Java são executadas através de 
uma máquina virtual, baseada em registradores e otimizada para consumir pouca 
memória, chamada Dalvik. Ao contrário da máquina virtual Java que executa by- 
tecodes, a Dalvik utiliza arquivos no formato .dex gerados a partir de classes Java 
compiladas. Esta conversão é feita pela ferramenta dx que acompanha o Android 
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SDK. 

Basicamente, o que é feito é o agrupamento de informações duplicadas que se 
encontram espalhadas em diversos arquivos .class em um arquivo .dex, com 
tamanho menor do que os arquivos que o originaram. O dx também faz a conversão 
de bytecodes para um conjunto de instruções específico da máquina virtual Dalvik. 

Depois de criado, o arquivo .dex e todos os recursos utilizados na aplicação, 
como imagens e ícones, são adicionados em um arquivo .apk, que é o aplicativo 
propriamente dito, capaz de ser instalado em um dispositivo. Estes arquivos se en- 
contram na pasta bin do projeto. 

É possível distribuir sua aplicação para outras pessoas apenas fornecendo o ar- 
quivo . apk. No entanto, para colocá-la na loja Google Play alguns outros passos são 
necessários, os quais serão detalhados em outro momento. A figura 2.1 demonstra o 
processo de geração do aplicativo. 


(= [Es |e too | tool |——> 


Figura 2.1: Processo de geração do aplicativo 





No sistema operacional Android, para cada aplicação é atribuído um usuário 
único de sistema e apenas este usuário recebe permissões para acessar seus arquivos. 
Além disso, por padrão, cada aplicação é executada em um processo próprio, que 
possui também sua própria instância da máquina virtual Dalvik. Sendo assim, ela é 
executada de forma segura e isolada das demais. 

Neste contexto, uma aplicação não pode acessar arquivos de outra e tampouco 
acessar diretamente recursos do sistema operacional como a lista de contatos, ca- 
mera, gps e rede, sem que o usuário explicitamente autorize o acesso durante a ins- 
talação dela. Diante dessas restrições de segurança, como tiramos proveito de toda 
a infraestrutura do Android e também de aplicativos de terceiros para incrementar 
as funcionalidades da nossa aplicação, incluindo por exemplo, um recurso de captu- 
rar fotos e vídeos e compartilhar via e-mail? Esse é justamente o ponto que vamos 
abordar na próxima seção. 


34 


Casa do Código Capítulo 2. Entenda o funcionamento do Android 





2.2 CONHEÇA AS INTENTS E INTENT FILTERS 


As Intents geralmente são criadas a partir de ações do usuário e representam a 
intenção de se realizar algo, como iniciar o aplicativo de correio eletrônico do An- 
droid ou iniciar a reprodução de uma música. Formalmente, as Intents podem 
ser definidas como mensagens enviadas por um componente da sua aplicação (uma 
activity, por exemplo) para o Android, informando a intenção de inicializar outro 
componente da mesma aplicação ou de outra. A imagem 2.2 demonstra as opções 
apresentadas pelo Android que correspondem às aplicações que são capazes de tra- 
tar a intenção informada pelo usuário. Neste exemplo, desejou-se compartilhar um 
texto selecionado. 


Compartilhar 


Bluetooth 


= 


Evernote - Criar 


ahotação Flipboard 


Gmail 


Linkedin Mensagens 





Figura 2.2: Aplicações que podem responder à intenção de compartilhar 
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Este é um recurso-chave no Android pois é através dele que podemos fazer com 
que as aplicações colaborem entre si, disponibilizando funcionalidades que podem 
ser reutilizadas, sem a necessidade de importar códigos ou dependências para den- 
tro da sua aplicação. Através de Intents é possível iniciar novas activities, 
como fazer uma busca e selecionar um contato do telefone, abrir a aplicação de ma- 
pas com as coordenadas de localização do GPS, abrir uma página da web, tirar fotos 
utilizando a câmera etc., apenas reaproveitando funcionalidades já existentes, dispo- 
nibilizadas pelos aplicativos instalados no aparelho. 

Além disso, aplicativos de terceiros, assim como os nossos, podem disponibilizar 
novas funcionalidades acessíveis via Intents. Existem, por exemplo, aplicativos de 
leitura de códigos de barra que podem ser chamados pela sua aplicação para lê-los 
utilizando a câmera do aparelho e devolver o resultado para ser processado por um 
método da sua aplicação. Podemos criar e utilizar as Intents de diversas maneiras 
e a seguir veremos alguns exemplos. O trecho de código abaixo mostra como abrir 
uma página utilizando o navegador que acompanha o Android: 


Uri uri = Uri.parse("http://www.android.com") ; 
Intent intent = new Intent(Intent.ACTION_VIEW, uri); 
startActivity (intent); 


Uma Uri foi criada a partir de uma string representando a URL que deseja- 
mos visitar. Em seguida, instanciamos uma nova Intent informando a ação que 





gostaríamos de executar ( Intent .ACTION VIEW), juntamente com a Uri criada, 
e chamamos o método startActivity daclasse Activity passandoa intent. 

Repare que não indicamos exatamente a activity que deve ser iniciada para 
abrir o site desejado. Neste caso, a nossa Intent é classificada como implícita. 





Com base na ação Intent .ACTION VIEW e o no conteúdo da Uri da Intent, 
o Android decide qual é atividade mais adequada para resolver a URL informada. 
Neste caso o escolhido é o navegador. 

A seguir, temos um exemplo de como iniciar uma nova atividade existente na 
nossa aplicação, passando no construtor da Intent a classe correspondente à ati- 
vidade que deve ser iniciada. 


Intent intent = new Intent(this, OutraAtividade.class) ; 
startActivity (intent); 


Diferentemente do exemplo anterior, agora nós informamos exatamente qual ati- 
vidade deve ser iniciada, ou seja, agora nossa Intent é explícita. Geralmente as 
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Intents explícitas são utilizadas apenas para interação entre componentes de uma 
mesma aplicação, já que é necessário conhecer o componente que deverá ser ativado, 
enquanto as implícitas são usadas para ativar componentes de outra aplicação, for- 
necendo informações adicionais, como a ação e Uri, para que o Android localize o 
componente adequado. 

Outra característica importante é que podemos colocar informações extras na 
Intent que serão utilizadas posteriormente pelo componente iniciado por ela. Para 
exemplificar, considere que a nossa aplicação deve tirar uma foto e armazená-la em 
uma pasta específica. 

O Android já possui um aplicativo que realiza esta tarefa, e o que queremos é 
chamá-lo a partir da nossa aplicação para capturar a imagem e salvá-la em um local 
determinado. O código abaixo inicia a Activity de câmera do aparelho, infor- 
mando o local e nome desejado para o armazenamento da imagem capturada: 


/* 
O exemplo considera que existe a pasta LivroDeAndroid 
e que o aplicativo tem permissão de escrita. 


*/ 


Uri uri = Uri.fromFile( 
new File("/sdcard/LivroDeAndroid/hello_camera.jpg")); 


Intent intent = new Intent (MediaStore.ACTION IMAGE CAPTURE) ; 
intent.putExtra(MediaStore. EXTRA OUTPUT, uri); 


startActivity (intent); 


Esse exemplo também utiliza Intents implícitas, pois em nenhum momento 
foi indicado qual a classe de Intent deveria ser utilizada. Em resumo, uma Intent 
é o conjunto de informações necessárias para ativar um componente de uma apli- 
cação. É composta basicamente de 5 informações. 


Nome do Componente 


O nome do componente é definido pelo nome completo da classe e o nome do 
pacote definido no AndroidManifest.xml que representam o componente que 
deve ser o encarregado de tratar a Intent. 

Quando criamos uma Intent explícita com o construtor Intent (this, 
OutraAtividade.class), o nome do componente é criado automaticamente. 
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No entanto, também é possível defini-lo de forma programática, utilizando os méto- 
dos setComponent (), setClass() ou setClassName () da classe Intent. 
Ação 


A ação é uma string que define o que deve ser realizado. Existem diversas 
ações genéricas no Android, disponibilizadas como constantes na classe Intent. 


Alguns exemplos de constantes são: 


e ACTION CALL - indica que uma chamada telefônica deve ser realizada. 





e ACTION VIEW - indica que algum dado deve ser exibido para o usuário. 





e ACTION 





E 


DIT - indica que se deseja editar alguma informação. 

















e ACTION SENDTO - indica que se deseja enviar alguma informação. 


Enquanto a Intent declara o que deve ser feito, o componente que a recebe 
é o responsável por definir como a ação será executada. Ou seja, para uma mesma 
ação, podemos ter comportamentos distintos quando ela for executada por diferen- 





tes componentes. Um exemplo disso éa ACTION VIEW, que pode ser utilizada tanto 
para indicar que desejamos abrir uma página da Internet quanto para abrir informa- 
ções de um contato armazenado no telefone. 


Dados 


Os dados de uma Intent são representados através de uma Uri ea 
partir dela, a aplicação decide o que deve ser feito. No primeiro exemplo de 
uso de intents criamos uma Uri para a página que gostaríamos de visi- 
tar. Outro exemplo seria criar uma Intent informando uma Uri com valor “ 
content://contacts/people/” que abriria os contatos do telefone: 


Uri uri = Uri.parse("content://contacts/people/") ; 
Intent intent = new Intent(Intent.ACTION_VIEW, uri); 
startActivity (intent); 


Informações extras 


As informações extras são quaisquer outros dados necessários para que o com- 
ponente execute a ação apropriadamente. Eles podem ser informados através dos 


extras da Intent. 
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No exemplo anterior, passamos uma Uri como extra para informar o local onde 
a foto deveria ser armazenada. Além disso, podemos também informar outros tipos 
de dados como strings, tipos primitivos, arrays e objetos serializáveis. Para 





incluir um dado como extra, utilizamos o método putExtra da classe Intent, 
fornecendo uma string como identificador do dado e o seu respectivo valor. Re- 





lembre com o código abaixo, no qualo MediaStore.EXTRA OUTPUT é o identifi- 
cador da informação ea uri éo extra: 


intent.putExtra (MediaStore. EXTRA OUTPUT, uri); 


Categoria 


A categoria, representada apenas por uma string, serve como informação 
adicional para auxiliar o Android na escolha de qual componente é o mais adequado 
para recebera Intent. Podemos adicionar várias categorias a uma Intent através 
do método addCategory. Assim como as ações, existem várias categorias prede- 
finidas, como a Intent .CATEGORY APP MUSIC, que, quando colocada em uma 





Intent, informará ao Android que uma Activity capaz de reproduzir músicas 
deve ser acionada. 


2.3 COMO AS INTENTS SÃO RESOLVIDAS 


As informações contidas nas Intents são utilizadas pelo Android para localizar 
o componente adequado, geralmente uma activity, para executar a ação dese- 
jada. Quando o nome de componente é informado, o Android inicializa exatamente 
aquele componente, sem necessidade de avaliar a ação ou categoria. 

Por outro lado, quando o nome não é informado, é necessário consultar quais 
são os componentes existentes com a habilidade de executar a ação desejada e que 
pertencem às categorias existentes na Intent. Adicionalmente, o Android também 
pode procurar por componentes capazes de resolver a Uri repassada e também de 
lidar com o formato dos dados, o MIME type, informado. 

A pergunta que deve estar latente é: como o Android sabe ou encontra a 
Activity que deve ser iniciada, apenas informando esses dados na Intent? A 
resposta é que não existe mágica e em algum lugar deve estar especificado que de- 
terminadas ações podem ser resolvidas por um dado componente. 

A definição de quais ações um componente está apto a responder, bem como a 
quais categorias ele pertence e também quais dados ele sabe tratar, é realizada através 
de intent filters que são configurados no arquivo AndroidManifest.xml. 
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No nosso primeiro exemplo já existe a declaração de um intent filter no 
AndroidManifest.xml paraa Activity principal da nossa aplicação: 


<activity 
android:name=".MainActivity" 
android:label="Ostring/title activity main" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


Este intent filter indica queaatividade MainActivity éaquela que deve 
ser iniciada ao abrir a aplicação e que também deve ser listada como uma aplicação 
do Android que pode ser utilizada por um usuario. Os intent filters podem 
ainda declarar, além da ação e da categoria, os tipos de dados com os quais o com- 


ponente é capaz de lidar, como uma imagem por exemplo: 


<data android:mimeType="image/*" /> 


Com base nestas três informações ( action, category e data), o Android 
é capaz de selecionar qual é o componente mais adequado para responder a uma 
Intent implícita, comparando o que foi passado na Intent com aquilo que está 
declarado nos intent filters dos aplicativos. Nossas aplicações podem definir 
intent filters com ações e categorias próprias ou fazer uso das já existentes 


para expor funcionalidades para as demais aplicações. 


2.4 CONSTRUÇÃO DA NOSSA PRIMEIRA INTENT 


Agora que já sabemos utilizar as Intents e compreendemos os Intent 
Filters, vamos tirar proveito disto alterando o nosso HelloWorld 2.0 para incluir 
uma activity que irá responder a uma intent implícita. 

A ideia é que na nossa aplicação de exemplo existam duas atividades: a 
MainActivity, que continuará sendo utilizada para o usuário informar o seu 
nome, ea SaudacaoActivity, que será responsável apenas por exibir uma sau- 
dação para o usuário a partir das informações contidas na intent. Ela também 
possuirá uma categoria própria e responderá a uma ação específica. A figura 2.3 de- 
monstra a ideia. 
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HelloAndroid n HelloAndroid 
Informe seu nome Olá Android 
Android 


Surpreenda-me! 





Figura 2.3: HelloWorld utilizando intents 


Primeiramente, devemos criar um novo XML de layout que será utilizado pela 
SaudacaoActivity para exibir a mensagem de saudação para o usuário. Para isto, 
acesse o menu File > New > Android XML Layout File. Informe o nome 
do arquivo como saudacao, não é necessário alterar nenhuma outra informação, 


como na figura 2.4: 
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eo New Android XML File 
New Android XML File 
Creates a new Android XML file. 


























Resource Type: | Layout aa 
Project: | HelloAndroid +) 
File: saudacao 

Root Element: 


Hl Linear Layout 

ListView 

D MediaController 

M MultiAutoCompleteTextView 
>) ProgressBar 

Fr “QuickContactBadge 

- RadioButton 


+ RadioGroup 
® RatingBar 
RelativeLayout 
E scroliview 











(2) < Back | Next> | | Cancel | [o Finish =) 





Figura 2.4: Criando um novo XML de layout 


Neste novo layout incluiremos apenas um TextView para mostrar a saudação 


ao usuário. O código ficará assim: 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


42 


android:layout width="match parent" 
android: layout height="match parent" 
android:orientation="vertical" > 


<TextView 
android: id="0+id/saudacaoTextView" 
android:layout width="match parent" 
android: layout_height="wrap_content"/> 
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</LinearLayout> 


Com o layout pronto, vamos criar uma nova Activity para a aplicação, através 
do menu File > New> Class. Na caixa de diálogo apresentada, selecione o 
pacote br.com.casadocodigo.helloandroide para o nome da classe informe 
SaudacaoActivity, conforme a figura 2.5 e pressione Finish. 




















ana New Java Class 
Java Class 
Create a new Java class. Q 
Source folder: HelloAndroid/src F Browse... | 
Package: br.com.casadocodigo.helloandroid E z [a Browse... | 
[_| Enclosing type: Browse. 
Name: SaudacaoActivity i 
Modifiers: @) public _) default private protected 
[_] abstract | | final static 
Superclass: java.lang.Object l | Browse.. | 
Interfaces: == 


Which method stubs would you like to create? 
|_| public static void main(Stringl] args) 
|_| Constructors from superclass 
aw Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 


| | Generate comments 


® rei) Sa) 


Figura 2.5: Criando uma nova classe 


Podemos então criar anossa SaudacaoActivity, que herdará de Activity: 
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public class SaudacaoActivity extends Activity { 


// teremos que implementar o método onCreate 


Na implementação do método onCreate, teremos a chamada para 
super. onCreate e em seguida precisamos indicar qual o layout será utilizado, 
que no nosso caso será o layout saudacao: 


public class SaudacaoActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.saudacao); 


Podemos definir constantes para identificar o extra que a intent possui, pois 
vamos utilizá-la nos métodos onCreate: 


public class SaudacaoActivity extends Activity { 
public static final String EXTRA NOME USUARIO = 
"helloandroid.EXTRA NOME USUARIO"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 
setContentView(R. layout .saudacao) ; 


Com isso, podemos recuperar a Intent, que nos foi passada através do 
método getIntent, e checar se existe um extra com o identificador defi- 
nido, ou seja, se a Intent possui o nome do usuário para a exibição da 
saudação. Caso exista um extra, obtemos o seu valor utilizando o método 
intent.getStringExtra (EXTRA NOME USUARIO). Sea intent fornecida 

















não possui nenhum extra, então apresentamos um aviso para o usuário. 


protected void onCreate (Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 


44 


Casa do Código Capítulo 2. Entenda o funcionamento do Android 





setContentView(R.layout.saudacao) ; 


TextView saudacaoTextView = 
(TextView) findViewById(R.id.saudacaoTextView) ; 


Intent intent = getIntent(); 
if (intent.hasExtra(EXTRA NOME USUARIO)) { 
String saudacao = getResources().getString(R.string.saudacao) ; 
saudacaoTextView.setText (saudacao + " " + 
intent. getStringExtra(EXTRA_NOME_USUARIQ)) ; 
} else { 
saudacaoTextView.setText ("0 nome do usuário não foi informado"); 


Em seguida, precisaremos alterar o método surpreenderUsuario da 
MainActivity para deixar de exibir a saudação e criar a Intent que acionará 
a nova atividade. Com isso, vamos ter que definir também a ação e a categoria da 
atividade que acabamos de criar. Podemos fazer isso definindo mais duas constantes 


na classe SaudacaoActivity: 


public class SaudacaoActivity extends Activity { 
public static final String EXTRA NOME USUARIO = 
"helloandroid.EXTRA NOME USUARIO"; 


// As duas novas constantes 
public static final String ACAO EXIBIR SAUDACAO = 
"helloandroid.ACAO EXIBIR SAUDACAO"; 


public static final String CATEGORIA SAUDACAO = 
"helloandroid.CATEGORIA_SAUDACAO" ; 


// método onCreate 


No método surpreenderUsuario, criamos uma nova Intent com a ação 
desejada e nela adicionamos a categoria definida anteriormente. Em seguida, incluí- 





mos como informação extra o valor informado no Edit Text. E por fim, iniciamos 


uma nova activity passandoa Intent criada. 


public void surpreenderUsuario(View v) 1 
Intent intent = new Intent (SaudacaoActivity.ACAO EXIBIR SAUDACAO) ; 
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intent.addCategory (SaudacaoActivity. CATEGORIA SAUDACAO) ; 


String texto = nomeEditText.getText().toString(); 
intent.putExtra(SaudacaoActivity.EXTRA NOME USUARIO, texto); 
startActivity(intent); 


Já que a exibição da mensagem de saudação é responsabilidade de outra ativi- 
dade, podemos excluir do layout utilizado pela MainActivity 0 TextView que 
tinha esse papel. No arquivo de layout activity main.xml, remova o último 





TextView declarado, com o id @saudacaoTextView, pois não precisaremos 
mais dele. 

As últimas alterações para que nossa SaudacaoActivity possa responder a 
uma Intent serão feitas no arquivo AndroidManifest.xml. 


Vamos adicionar um novo bloco de activity, declarações nas quais estabele- 





cemos quea SaudacaoActivity responde pela ACAO EXIBIR USUARIO etam- 
bém atende a intents que pertencem à CATEGORIA SAUDACAO: 





<activity 
android:name="br.com.casadocodigo.helloandroid.SaudacaoActivity"> 
<intent-filter> 
<action android:name="helloandroid.ACAO EXIBIR SAUDACAO" /> 
<category android:name="helloandroid.CATEGORIA SAUDACAO" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 


Quando desejamos que uma activity receba intents implícitas, 


é obrigatório que no intent filter também seja incluída a categoria 





android. intent.category.DEFAULT. Para cada activity é possível definir 
vários intent filters, com configurações diferentes de ação e categoria. Já po- 
demos executar a aplicação para testar! O resultado deve ser o mesmo apresentado 
na imagem 2.3. 


2.5 COMPONENTES DE APLICAÇÃO 


Até aqui já desenvolvemos uma aplicação de exemplo e já tivemos contato 
com um dos componentes mais importantes da plataforma Android, que são as 


46 


Casa do Código Capítulo 2. Entenda o funcionamento do Android 





Activities. Agora chegou o momento de conhecer quais são os outros tipos de 
componentes. 

Para construir uma aplicação Android, podemos utilizar quatro tipos de compo- 
nentes, cada qual com um propósito e ciclo de vida bem definidos, são eles: activities, 
services, content providers e broadcast receivers. 


* Activities - uma atividade representa uma tela com interface gráfica capaz de 
promover algum tipo de interação com o usuário. Já utilizamos este tipo de 
componente para implementar nossa primeira aplicação. Uma aplicação An- 
droid pode ser composta de diversas activities para fornecer um conjunto de 
funcionalidades para o usuário. 


e Services - os serviços são componentes executados em segundo plano e que 
não dispõem de interface gráfica. Seu objetivo principal é realizar tarefas que 
podem consumir muito tempo para executar, sem comprometer a interação 
do usuário com alguma activity. Tocar uma música ou fazer o download 
de um arquivo são exemplos de funcionalidades que podem ser implementa- 
das utilizando services. 


* Content providers - os provedores de conteúdo são componentes que per- 
mitem o acesso e modificação de dados armazenados em um banco de dados 
SQLite local, de arquivos armazenados no próprio dispositivo ou mesmo da- 
dos armazenados na web. Os content providers podem ser expostos para uso 
por outras aplicações, com o objetivo de compartilhar dados, ou serem utili- 
zados apenas pela aplicação que os contém. 


e Broadcast receivers - são componentes capazes de responder a eventos pro- 
pagados pelo sistema operacional Android, como por exemplo o nível baixo 
da bateria, ou eventos originados por uma aplicação, como o recebimento de 
uma nova mensagem de texto. 


Não é necessário que uma aplicação Android tenha todos estes componentes mas 
é importante conhecê-los para que, no momento de projetar a aplicação, possamos 
selecionar o componente adequado para atender às necessidades. Nos capítulos 5 e 
6 vamos explorar mais o uso de cada componente. 
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2.6 CICLO DE VIDA DA ACTIVITY 


A Activity é um componente de aplicação com um ciclo de vida específico. 
Quando o usuário acessa a aplicação, navega pelas opções, sai ou retorna para a 
mesma, as atividades que a compõem passam por uma série de estados do ciclo de 
vida. Entender como ele funciona é importante para preparar a aplicação para lidar 
com situações que podem interferir na sua execução, tais como o recebimento de 
uma ligação, desligamento da tela do aparelho ou ainda a abertura de outra aplica- 
ção feita pelo usuário. A imagem 2.6 ilustra o ciclo de vida da Activity. 


— 


onResume() onPause() 
onResume() 


onStart() onStop() 
onStart() 


—— onRestan() 
onCreate() onDestroy() 


EER 
Figura 2.6: Ciclo de vida da Activity. Fonte: developer.android.com 


Sempre que a Activity muda de estado, o Android aciona um método ( 
callback) correspondente. Assim que o usuário inicia uma aplicação, o Android 
cria a atividade principal que está declarada no AndroidManisfest.xml e in- 
voca o seu método onCreate. Como já vimos, é neste método que atribuímos qual 
layout será utilizado pela nossa atividade e também inicializamos variáveis e recursos 
necessários. 

Em seguida, o Android invoca os métodos onStart e logo após o onResume. 
A Activity torna-se visível para o usuário no estado Started e assim permanece 
até os métodos onPause (visível parcialmente) ou onDestroy serem chamados. 
Quando a Activity está no estado Resumed dizemos que ela está no foreground 
e pode realizar interação com o usuário. 


A Activity muda para o estado Paused quando for parcialmente encoberta 
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por outra Activity, que pode não ocupar toda a tela ou ser transparente. Se o 
usuário sair da aplicação ou iniciar outra atividade que encubra totalmente a que 
está sendo executada, então o método onStop é invocado ea Activity vai para 
o background. Mesmo não sendo mais visível pelo usuário, a Activity conti- 
nua instanciada e com seu estado interno inalterado, ou seja, da forma como estava 
quando em execução. 

Quando uma Activity está nos estados de Paused ou Stopped, o sistema 
operacional pode removê-la da memória, invocando o seu método finish ou en- 
cerrando arbitrariamente o seu processo. Nestas condições, o método onDestroy 
é disparado. Após destruída, sea Activity for aberta novamente, ela será recriada. 

Podemos sobrescrever esses métodos para acrescentar ações que devem ser rea- 
lizadas em determinado estágio do ciclo de vida. Por exemplo, quando a Activity 
não estiver mais visível, podemos liberar recursos tais como uma conexão de rede, 
ou ainda, salvar os dados digitados pelo usuário no método onPause e encerrar as 
threads em execução no método onDestroy. O código a seguir mostra os métodos 
que podemos sobrescrever: 


public class MinhaActivity extends Activity { 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
// A activity está sendo criada 
} 
@Override 
protected void onStart() { 
super .onStart (); 
// A activity está prestes a se tornar visível 
} 
@Override 
protected void onResume() { 
super . onResume () ; 
// A activity está visível 
} 
@Override 
protected void onPause() { 
super .onPause() ; 
/* Outra activity esta recebendo o foco. Esta activity 
ficara pausada */ 
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@Override 
protected void onStop() { 
super.onStop() ; 
// A activity não está mais visível mas permanece em memória 
} 
@Override 
protected void onDestroy() { 
super.onDestroy() ; 
// A activity está prestes a ser destruída (removida da memória) 


Lembre-se sempre de invocar a implementação padrão do método que está 
sendo sobrescrito. Por exemplo, se estiver sobrescrevendo o método onStop, então 
invoque antes o método super .onsStop (). 


2.7 LAYOUTS, WIDGETS E TEMAS 


Sem dúvida uma interface gráfica com boa usabilidade e que provê uma excelente 
experiência de uso, assim como funcionalidades bem implementadas, são fatores 
importante para o sucesso de uma aplicação mobile. A plataforma Android nos ofe- 
rece um bom conjunto de componentes visuais, os chamados widgets, bem como 
opções de layout variadas para a criação da interface com o usuário. 

O elemento fundamental de uma interface gráfica na plataforma Android é a 
View. A partir dela é que são derivados todos os demais elementos como botões, 
imagens, checkboxes, campos para entrada e exibição de textos e também widgets 
mais complexos como seletores de data, barras de progresso e de pesquisa e até 
mesmo um widget para exibir páginas web, o WebView. A imagem abaixo mos- 
tra alguns deles: 








do hash + 
Spinner x | CheckBox | | | 
| 02 | Apr | 2012] 
Button OFE (®) RadioButton Do) || | fame ul 
Po DatePicker 
RatingBar SeekBar ProgressBar 


Figura 2.7: Alguns widgets disponíveis 


50 


Casa do Código Capítulo 2. Entenda o funcionamento do Android 





Outra classe essencial é a ViewGroup, que tem como característica especial a 
possibilidade de conter outras Views e é a base para todas as classes que constituem 
layouts. O diagrama da figura 2.8 mostra a hierarquia desses elementos. 


















ProgressBar 
é me md 
oe 











RelativeLayout 
= 


Figura 2.8: Hierarquia de Views 


Outro recurso interessante disponibilizado pelo Android é a criação de estilos e 
temas para personalizar a sua aplicação. Se você já trabalhou com folhas de estilo 
CSS e design para web perceberá a similaridade entre eles. Para definir um estilo, 
basta criar um XML em res/values/ definindo as propriedades desejadas, como 
no exemplo abaixo que define a cor do texto e o tipo de fonte: 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<style name="TitleFont" 
parent="Q@android:style/TextAppearance.Large"> 
<item name="android:layout_width">fill_parent</item> 
<item name="android:layout_height">wrap_content</item> 
<item name="android:textColor">#FFBA00</item> 
<item name="android: typeface" >monospace</item> 
</style> 
</resources> 


Ha ainda a possibilidade de derivar estilos existentes. Na linha 3, fazemos isto 
informando qual é o estilo-pai. Para aplicar o estilo em um Text View por exemplo, 
basta referenciar o estilo dessa maneira: 


<TextView style="@style/TitleFont" android:text="Ostring/titulo" /> 
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Como é de se imaginar, os temas são conjuntos de estilos que podem ser apli- 
cados em uma ou em todas as activities da aplicação. Para experimentar esse re- 
curso, no arquivo AndroidManifest .xm1 da nossa aplicação de exemplo, pode- 
mos incluir o atributo android: theme="@android:style/Theme.Black" na 
tag application e executar a aplicação novamente. Agora ela está com uma apa- 
rência mais escura como mostrado na figura 2.9. 


Surpreenda-me 





Figura 2.9: Aplicação Hello Android com outro tema 


2.8 CONCLUSÃO 


Neste capítulo compreendemos como as aplicações são geradas e empacotadas para 
execução na máquina virtual Dalvik, além de uma visão geral dos componentes 
de aplicação (activities, services, content providers e broadcast receivers). Através de 
exemplos, exploramos um recurso-chave na plataforma Android que são as Intents. 
Além disso, foi apresentado o ciclo de vida da Activity e em quais situações ela 
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muda de estado. 

A organização dos elementos de interface gráfica, widgets e layouts foi apresen- 
tada assim como a utilização de estilos e temas para a modificação da aparência da 
aplicação. Todos os itens apresentados aqui servem como alicerce para os demais 
capítulos, que fazem uso desses conceitos fundamentais para o desenvolvimento de 
aplicações concretas e cada vez mais elaboradas. 
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CAPÍTULO 3 


Domine os principais elementos de 
Interface Gráfica 


Neste capítulo iremos explorar a construção de interfaces gráficas e daremos início 
à implementação de uma aplicação que nos acompanhará durante todo o restante 
do livro. A aplicação que iremos desenvolver servirá para nos ajudar a controlar os 
gastos realizados em nossas viagens de lazer ou negócios. Não é uma ideia revolu- 
cionária, mas irá nos ajudar muito, pois uma aplicação assim possui um domínio 
muito rico, além de revelar problemas comuns do desenvolvimento para Android. 

Nossa aplicação será batizada de BoaViagem e nela poderemos criar uma nova 
viagem, informando os destinos, datas de chegada e partida e se ela é de negócios ou 
lazer. Para cada viagem, poderemos informar os gastos realizados por categoria, tais 
como alimentação, passeios, locomoção e hospedagem. 


Casa do Código 








CÓDIGO FONTE COMPLETO DO PROJETO 


Caso queira, você pode consultar o código fonte completo do Bo- 
aViagem, que deixei disponível no meu github: https://github.com/ 
joaobmonteiro/livro-android. 

Os exemplos estão organizados por capítulo. Portanto, fique à von- 
tade para baixar, consultar, sugerir melhorias e incrementar a aplicação. 











Também se deverá informar qual o orçamento disponível para a realização da 
viagem. Esta informação poderá ser usada para que a aplicação nos alerte quando 
estivermos próximos de ultrapassar o limite de gastos estabelecido. Estas são as fun- 
cionalidades principais e no decorrer do livro aprenderemos outras coisas como a 
captura de fotos, uso do GPS e mapas, integração e compartilhamento de dados que 
você pode posteriormente incluir como nova funcionalidade do aplicativo. A ima- 
gem 3.1 mostra algumas de suas telas. 





Figura 3.1: Telas do BoaViagem 


Para começar, vamos criar as telas com o objetivo de conhecer os diversos tipos 
de layout e os widgets básicos para compor formulários de entrada de dados e no 
capítulo seguinte incluiremos a persistência destes dados. Então vamos lá! Caso 
queira seguir codificando, crie um novo projeto Android, com o nome BoaViagem e 
o pacote br.com.casadocodigo.boaviagem, da mesma forma que fizemos no 
capítulo 1. 

Neste primeiro momento nos preocuparemos com as duas telas iniciais da apli- 
cação, a tela de login e a tela inicial de opções, comumente chama de dashboard. 
Abaixo temos o protótipo com os detalhes dos tipos de layout que iremos utilizar. 
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BoaViagem 


3G ml 8:30PM | 


Nova Viagem 


Minhas Viagens Configurações! 





Q LinearLayout Q RelativeLayout 


Figura 3.2: Tela de login e dashboard 


3.1 LINEARLAYOUT 


Para a tela de login, utilizaremos o LinearLayout, que permite a organização dos 
elementos de forma linear, posicionando itens um abaixo do outro, quando confi- 
gurado com orientação vertical, ou um ao lado do outro, quando configurado com 
orientação horizontal. Às vezes escolher a orientação certa causa um pouco de con- 
fusão, então a dica é se lembrar de que a orientação diz respeito à direção na qual os 
itens serão incluídos na tela. Ou seja, na orientação vertical, os itens serão incluídos 
no layout de cima para baixo e na orientação horizontal, da esquerda para a direita. 
Então para fazer uma tela de login parecida com a do protótipo 3.2, utilizaremos 
um LinearLayout, com orientação vertical. Para esta tela, podemos criar um 
novo arquivo de layout com o nome de login.xml. O primeiro passo é definir o 
LinearLayout que queremos e dizer que a orientação será vertical: 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
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android: layout height="match parent" 
android:gravity="center vertical" 
android:orientation="vertical" > 


<!-- Campos virão aqui --> 
</LinearLayout> 


Para especificar um layout existem dois atributos fundamentais: o 
layout width (linha 3), que indica a largura do elemento, e layout height 
(linha 4), que indica a sua altura. Há dois valores importantes para estes atributos 
que sãoo match parent eo wrap content. O primeiro valor indica que o 
tamanho deve ser o mesmo que o do elemento-pai enquanto o segundo indica que 
o tamanho deve ser grande o suficiente para abrigar o conteúdo a ser exibido. 

Note que na linha 5 utilizamos um outro atributo, que é o 
android:gravity="center vertical". Ele indica que o layout deve fi- 
car centralizado verticalmente na tela. A orientação que desejamos é informada no 
atributo android:orientation. 

O próximo passo é exibir a logo da aplicação. Para isso, podemos in- 
cluir um ImageView, que deve ficar ao centro e mostrar a imagem de 
android: src="@drawable/logo". Com isso, basta ter uma imagem em um ar- 


quivo logo.png e colocá-la nos diretórios drawable do projeto. 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout ...> 


<ImageView 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_gravity="center" 
android: layout_marginBottom="50dp" 
android:src="@drawable/logo" /> 


</LinearLayout> 


Agora, podemos incluir os campos para que o usuário forneça seu login e senha 
para entrar na aplicação. Precisaremos de componentes Text View para mostrar a 





descrição dos campos, como se fossem labels, e também do Edit Text para o campo 
onde o usuário digitará seu login: 
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<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout ...> 


<!-- Logo --> 


<TextView 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:text="Ostring/usuario" /> 


<EditText 
android: id="0+id/usuario" 
android: layout width="match parent" 
android:layout height="wrap content" 
android: inputType="text" > 


<requestFocus /> 
</EditText> 
</LinearLayout> 





Repare no Edit Text: definimos um atributo android: inputType, para in- 
dicar que esse campo é uma simples entrada de texto, ou seja, caracteres alfanumé- 
ricos. Também utilizamos o <requestFocus> para que este campo receba o foco 
quando a tela for exibida. 





Com isso, para fazermos o campo de senha, basta criarmos um novo Edit Text 
cujo android: input Type seja do tipo textPassword: 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout ...> 
<!-- Logo --> 
<!-- Campo de login do usuario --> 
<TextView 


android: layout_width="wrap_content" 

android:layout height="wrap content" 

android:text="Ostring/senha" /> 
<EditText 

android: id="0+id/senha" 

android: layout width="match parent" 
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android: layout height="wrap content" 
android: inputType="textPassword" /> 


</LinearLayout> 





Como ADICIONAR ROLAGEM VERTICAL 


Os layouts do Android não suportam por padrão a rolagem ver- 
tical da tela. Para ter essa funcionalidade, é necessário utilizar uma 
ScrollView e colocar o layout que precisa da rolagem como seu 
elemento-filho. 











Além dos tipos text e textPassword, também existem diversos outros, tais 
como 0 number, que indica números e faz com que o teclado exibido para digitação 
seja apenas o teclado numérico; phone, para números de telefone; date e time, 
para informações de data e hora. Para ver todas as opções disponíveis consulte a 
documentação em http://developer.android.com/reference. 


Agora basta fazermos o botão entrar, usando a Tag Button: 


<Button 
android: layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="bottom" 
android: onClick="entrarOnClick" 
android: text="@string/entrar" /> 


Nesse botão, vinculamos a ação entrarOnClick que fará a autenticação do 
usuário e, caso seja bem-sucedida, iniciará a activity da dashboard. Vamos im- 
plementar este método na BoaViagemActivity que utilizará o layout da tela de 
login que acabamos de definir. 


public class BoaViagemActivity extends Activity { 


public void entrarOnClick(View v) { } 


Note que fizemos o método ent rarOnClick recebendo como parâmetro um 
objeto do tipo View. Vamos implementar a lógica do login dentro desse método 


60 


Casa do Código Capítulo 3. Domine os principais elementos de Interface Gráfica 





em instantes. Mas primeiro, faremos com que, quando a BoaViagemActivity 
seja criada, ela fique associada ao layout do login. Para isso, vamos reescrever o mé- 
todo onCreate e invocar o método setContentView, passando uma referência 


ao layout de login. 


public class BoaViagemActivity extends Activity { 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 
setContentView(R.layout.login) ; 


public void entrarOnClick(View v) { } 





A CLASSE R 


A classe R é gerada automaticamente pelo ADT, utilizando as ferra- 
mentas do SDK, e serve para mapear os recursos existentes no aplicativo 
na forma de constantes. Dessa forma, podemos referenciar facilmente 
arquivos de layout, widgets e outros tipos de recursos como strings:: 


e arrays. 











Nesse começo, faremos uma autenticação simples, na qual o usuário informado 
deve ser “leitor” e a senha deve ser “123”. Mas para isso temos que recuperar uma 
referência para os campos de usuário e senha que estão na tela, para termos acesso 
aos textos presentes nos campos. No próprio método onCreate, vamos recuperar 





referências para os dois Edit Text, através do método findViewBylId. 


public class BoaViagemActivity extends Activity { 
private EditText usuario; 
private EditText senha; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.login); 
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usuario = (EditText) findViewById(R.id.usuario); 
senha = (EditText) findViewById(R.id.senha) ; 


Note que foi passado para o findViewById uma referência para 
R.id.usuario e em seguida para R.id.senha. Essas são referências para 
os EditText que criamos anteriormente na tela e demos o nome de usuario e 
senha. 

Com esses componentes recuperados, agora podemos descobrir qual é o texto 
que está neles quando o método entrarOnClick for invocado: 


public void entrarOnClick(View v) { 
String usuarioInformado = usuario. getText().toString() ; 
String senhaInformada = senha.getText() .toString() ; 


if("leitor".equals(usuarioInformado) && 
"123". equals(senhaInformada)) { 
// vai para outra activity 
+ elsef 
// mostra uma mensagem de erro 


No caso de falha na autenticação, deve-se exibir uma mensagem para o usuário, 
através do widget Toast, que serve para apresentar uma notificação rápida para o 
usuário, informando o resultado de alguma operação. É possível definir por quanto 





tempo a mensagem ficará visível, através de uma duração Toast . LENGTH SHORT 
ou Toast.LENGTH LONG. 





if("leitor".equals (usuarioInformado) && 
"123" .equals (senhaInformada)) { 
// vai para outra activity 
} else { 
String mensagemErro = getString(R.string.erro_autenticao) ; 
Toast toast = Toast.makeText(this, mensagemErro, 
Toast.LENGTH SHORT); 
toast.show() ; 
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Repare que recuperamos a mensagem de erro em um arquivo strings.xml, 
através de R.string.erro autenticacao, ou seja, temos nesse arquivo uma 


mensagem cujo nome é erro autenticacao: 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<!-- mensagens padrão --> 


<string name="erro autenticacao">Usuário ou senha inválidos</string> 


</resources> 


A única coisa que falta agora é redirecionar o usuário para outra acti- 
vity caso a autenticação seja feita corretamente. Para isso, criaremos uma 
DashboardActivity que vamos implementar nas próximas seções e falar que, ao 


autenticar, essa activity será iniciada: 


if("leitor".equals (usuarioInformado) && 
"123" .equals (senhaInformada))( 
startActivity (new Intent(this,DashboardActivity.class)); 
} else { 
String mensagemErro = getString(R.string.erro autenticao); 
Toast toast = Toast .makeText (this, mensagemErro, 
Toast .LENGTH SHORT); 
toast.show(); 


3.2 RELATIVELAYOUT 


O próximo passo é criar o layout e a atividade para exibir a tela de opções da 
nossa aplicação, o dashboard. Para esta tela, utilizaremos uma combinação do 
LinearLayout, que acabamos de ver, com o RelativeLayout. É bastante co- 
mum, e muitas vezes necessário, aninhar diversos tipos de layout. 

O RelativeLayout, um dos mais poderosos e versáteis disponíveis na plata- 
forma Android, permite posicionar um elemento em um local relativo a outro com- 
ponente. É possível, por exemplo, posicionar uma imagem abaixo de um botão, que 
fica à esquerda de um TextView. Vamos criar um novo arquivo XML de layout 
chamado dashboard.xm1. O objetivo é que tenhamos, além da tela de login, uma 
nova tela com as ações que podemos fazer na aplicação, como na imagem 3.3. 
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BoaViagem 


Novo Gasto Nova Viagem 


de = 


Minhas Viagens Configurações 





Figura 3.3: Tela de login e dashboard da aplicação 


Para construirmos essa nova tela, vamos adicionar o RelativeLayout que 
deve ocupar todo o espaço restante deixado pelo LinearLayout: 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: background="#333333" 
android: orientation="Vvertical"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android: text="@string/app_name" 
android: textAppearance="?android:attr/textAppearanceLarge" /> 


<RelativeLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android: background="#015488"> 
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<!-- Vamos adicionar elementos aqui --> 
</RelativeLayout> 


</LinearLayout> 


Para representar cada opção da dashboard, vamos utilizar TextViews que serão 
alinhados de forma relativa aos demais elementos na tela. Para posicionar o primeiro 
elemento da dashboard no canto superior esquerdo, incluiremos um Text View que 
define um tamanho de margem esquerda ( layout marginLeft) e para o topo 
(layout marginTop). 

Este elemento não possui nenhuma informação específica de layout relativo, 
apenas de margens, mas servirá de referência para o próximo TextView. Este, 
por sua vez, ficará no canto superior direito. Então, iremos colocá-lo ao lado di- 
reito do seu componente-pai (o próximo RelativeLayout), utilizando o atributo 
layout alignParentRight-true. Também é preciso alinhar o seu topo com 
o do TextView âncora referente ao “Novo Gasto”. Para isto, utiliza-se o atributo 





layout. alignTop informando o id do elemento que será a referência, no caso é 


o “@id/novo_gasto’, veja: 


<RelativeLayout ...> 


<TextView 
android: id="@+id/novo_gasto" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_marginLeft="50dp" 
android: layout_marginTop="80dp" 
android: clickable="true" 
android: drawableTop="@drawable/novo_gasto" 
android: onClick="selecionarOpcao" 
android: text="@string/novo_gasto" 
android: textColor="#FFFFFF" 
android: textStyle="bold" /> 


<TextView 
android: id="@tid/nova_viagem" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
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android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


layout alignParentRight="true" 
layout alignTop="QGid/novo gasto" 
layout marginRight="50dp" 
clickable="true" 
drawableTop="@drawable/nova_viagem" 
onClick="selecionarOpcao" 
text="Ostring/nova viagem" 
textColor="#FFFFFF" 


textStyle="bold" /> 


</RelativeLayout> 


Também em relação ao Text View do novo gasto, alinhamos o item “Minhas 


Viagens” à esquerda e, para mantê-lo na parte de baixo da tela, especificamos que ele 


deve se alinhar como a região inferior do componente-pai, através da propriedade 


android: layout alignParentBottom="true". 


O último TextView, para a opção de configurações da aplicação, utiliza o 


TextView anterior para se alinhar na região inferior da tela e também se alinha 


à direita com base no Text View da “Nova Viagem”. É importante ressaltar que po- 


demos obter o mesmo resultado (mesmo design de tela) utilizando outros tipos de 


layouts ou utilizando os mesmos layouts mas de forma diferente das apresentadas 


aqui: 


<RelativeLayout 


o 


<!-- Novo gasto e nova viagem --> 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
:textStyle="bold" /> 


android 
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id="0+id/minhas viagens" 

layout width="wrap content" 
layout height="wrap content" 
layout alignLeft="0id/novo gasto" 
layout alignParentBottom="true" 
layout marginBottom="120dp" 
clickable="true" 
drawableTop="@drawable/minhas_viagens" 
onClick="selecionarOpcao" 
text="Qstring/minhas_viagens" 
textColor="#FFFFFF" 
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<TextView 
android 


android: 
android: 


android 


android: 
android: 
android: 


android 


android: 
android: 
android: 


:id="0+id/configuracoes" 


layout width="wrap content" 
layout height="wrap content" 


:layout alignBottom="0Oid/minhas viagens" 


layout alignRight="Q0id/nova viagem" 
clickable="true" 
drawableTop="@drawable/configuracoes" 


:onClick="selecionar0pcao" 


text="Qstring/configuracoes" 
textColor="#FFFFFF" 
textStyle="bold" /> 


</RelativeLayout> 


Dessa forma, o código completo utilizando os dois layouts fica assim: 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


android: layout_width="match_parent" 


android: layout_height="match_parent" 
android: background="#333333" 
android: orientation="Vvertical" > 


<TextView 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android: text="@string/app_name" 
android: textAppearance="?android:attr/textAppearanceLarge" /> 
<RelativeLayout 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: background="#015488" > 
<TextView 


android: id="@+id/novo_gasto" 


android:layout width="wrap content" 


android:layout height="wrap content" 
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android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 


layout marginLeft="50dp" 

layout marginTop="80dp" 
clickable="true" 
drawableTop="@drawable/novo_gasto" 
onClick="selecionar0pcao" 
text="Ostring/novo gasto" 
textColor="HFFFFFF" 
textStyle="bold" /> 


id="0+id/nova viagem" 

layout width="wrap content" 
layout height="wrap content" 
layout alignParentRight="true" 
layout alignTop="0id/novo gasto" 
layout marginRight="50dp" 
clickable="true" 
drawableTop="@drawable/nova_viagem" 
onClick="selecionarOpcao" 
text="Qstring/nova_viagem" 
textColor="#FFFFFF" 
textStyle="bold" /> 


id="0+id/minhas viagens" 

layout width="wrap content" 
layout height="wrap. content" 
layout alignLeft="0id/novo gasto" 
layout alignParentBottom="true" 
layout marginBottom="120dp" 
clickable="true" 
drawableTop="@drawable/minhas_viagens" 
onClick="selecionar0pcao" 
text="Ostring/minhas viagens" 
textColor="HFFFFFF" 
textStyle="bold" /> 


id="@+id/configuracoes" 
layout width="wrap content" 
layout height="wrap content" 
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android: layout_alignBottom="@id/minhas_viagens" 
android: layout_alignRight="@id/nova_viagem" 
android: clickable="true" 
android: drawableTop="@drawable/configuracoes" 
android: onClick="selecionarOpcao" 
android: text="@string/configuracoes" 
android: textColor="#FFFFFF" 
android: textStyle="bold" /> 

</RelativeLayout> 


</LinearLayout> 





DICA 


Utilize a visualizacao grafica do layout na IDE para ter uma prévia de 
como esta ficando a tela. 











Para representar cada opção na dashboard utilizamos o widget Text View que, 
além da possibilidade de exibir textos, também pode exibir uma imagem associada. 
Essas imagens podem ser posicionadas a esquerda, a direita, acima ou abaixo do 
texto que sera exibido. No nosso caso, optamos por coloca-la acima do texto, infor- 
mado a imagem desejada no atributo drawableTop. Também especificamos que 
nossos TextViews podem ser clicados, através do atributo clickable e que o 
texto deve estar em negrito e ser da cor branca (atributos text Style e textColor 
respectivamente). 





CUIDADOS COM MUITOS LAYOUTS ANINHADOS 


Utilizar muitos layouts aninhados pode trazer problemas de desem- 
penho. Prefira desenvolver layouts que possuem poucos níveis de ani- 
nhamento. Consulte o seguinte guia para obter dicas de como melhorar 
o desempenho nessas situações http://developer.android.com/training/ 
improving-layouts/index.html 











Para darmos continuidade à implementação da tela inicial de opções, vamos 
usar a classe DashboardActivity. Esta nova atividade deve utilizar o layout 
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dashboard.xml e responder aos métodos disparados quando uma opção for se- 
lecionada. Por enquanto, o código dela ficará assim: 


public class DashboardActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.dashboard); 


public void selecionar0pcao(View view) { 
/* 
com base na view que foi clicada 
iremos tomar a ação correta 
*/ 
TextView textView = (TextView) view; 
String opcao = "Opção: " + textView.getText() .toString() ; 
Toast .makeText (this, opcao, Toast.LENGTH_LONG) .show() ; 


E importante lembrar que todas as atividades que forem criadas devem ser de- 
claradas no AndroidManifest.xml. Além disso, queremos suprimir a barra de 
título padrão, o que também é feito no AndroidManifest.xml configurando 
para nossa aplicação o tema @android:style/Theme.NoTitleBar. Com isso, 
o AndroidManifest.xml ficará parecido com: 


<?xml version="1.0" encoding="utf-8"?> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="br.com. casadocodigo.boaviagem" 
android: versionCode="1" 
android: versionName="1.0" > 


<uses-sdk android:minSdkVersion="10" /> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name" 
android: theme="@android:style/Theme.NoTitleBar" > 
<activity 
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android:name=".BoaViagemActivity" 
android: label="@string/app_name" > 
<intent-filter> 


<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".DashboardActivity" /> 
</application> 


</manifest> 


Com a tela de login e dashboard prontas, podemos executar a nossa aplicação e 
comparar as telas criadas com os prototipos apresentados na imagem 3.2. Ficaram 
parecidas, não é mesmo? 





DICA 


Durante o desenvolvimento dos layouts da aplicação, é comum exe- 
cutarmos o aplicativo várias vezes para ver como está ficando. Para evitar 
que seja necessário navegar e ir selecionando opções até chegar na acti- 
vity desejada, inclua o intent-filter na activity a ser testada para 
que ela seja a primeira a ser iniciada. 











3.3 TABLELAYOUT 


As próximas telas que iremos implementar serão a criação de uma nova viagem e 
o registro de um novo gasto. São telas tipicamente de cadastro e permitirão que 
sejam explorados diversos widgets para entrada de dados, tais como os Spinner, 





DatePicker e nosso já conhecido Edit Text, além de mais um tipo de layout, o 
TableLayout. O protótipo das telas é o seguinte: 
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G ull 8:30 PM 3G all 8:30 PM 
Tipo 


Alimentação 


Tipo da viagem Valor Data 


O Lazer O Negócios R$ 21,90 12/4/2012 


Data de chegada Data de partida 


05/04/2012 12/4/2012 Descrição 
Lanche 


Orçamento 
R$ 4.500,00 


Quantidade de pessoas 


Criar nova viagem 





Figura 3.4: Telas de cadastro de viagem e de gasto 


Começaremos pela tela de cadastro de uma nova viagem. Para este layout uti- 
lizaremos uma combinação de LinearLayout e TableLayout. Como o nome 
sugere, 0 TableLayout permite a criação de layouts com a organização em formato 
de tabelas, similar ao <table> do HTML. O elemento TableRow é utilizado para 
representar uma linha e seus elementos-filhos representam uma célula. Por exemplo, 
se uma TableRow possui dois elementos, então aquela linha possui duas colunas. 

Ainda podemos utilizar qualquer outra view que não a TableRow para repre- 
sentar uma linha. Neste caso, a view utilizada representa uma célula e uma única 
coluna para aquela linha. Ou seja, com isso temos um comportamento parecido com 
o colspan do HTML, no qual uma célula se estende por várias colunas. 

O TableLayout também tem outra característica importante: todos os seus 
elementos-filhos não podem especificar o atributo layout. width, que por padrão 





já possuem o valor MATCH PARENT. No entanto, o atributo layout. height pode 





ser definido (o valor padrão é WRAP. CONTENT), exceto quando o elemento-filho for 





uma TableRow que terá sempre o valor WRAP. CONTENT. 
Isto por um lado é bom, pois evita que tenhamos que especificar inúme- 
ros atributos de layout, mas por outro, pode limitar as situações de uso do 
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TableLayout por não termos este ajuste fino. Esta característica nos levou a in- 
cluir um LinearLayout para incluirmos um título centralizado na tela. Ainda 
utilizamos uma ScrollView para prover a rolagem da tela quando necessário. 


<?xml version="1.0" encoding="utf-8"?> 

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout height="match parent" > 


<TableLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: stretchColumns="0,1,2" > 


<LinearLayout 
android: background="#015488" 
android: orientation="Vertical" > 


<TextView 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_gravity="center" 
android: text="@string/nova_viagem" 
android: textAppearance= 
"?android:attr/textAppearanceLarge" 
android:textStyle="bold" /> 
</LinearLayout> 


</ScrollView> 


O TableLayout possui dois atributos muito úteis para ajustar o tamanho das 
colunas. Um deles é o stretchColumns (linha 10), que permite que as colunas in- 
dicadas ocupem todo o espaço disponível entre os seus elementos-filhos e o próprio 





TableLayout. Como a configuração de largura do nosso layout é MATCH. PARENT, 
então as colunas devem expandir o seu tamanho de modo a ocupar toda a tela. 

O outro atributo éo shrinkColumns que indica que determinadas colunas 
podem ter seu tamanho reduzido quando requisitado pelo TableLayout. O va- 
lor desses atributos é o índice (iniciando em 0) referente às colunas desejadas. O 
TableLayout adiciona as linhas e os elementos de layout na sequência em que apa- 
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recem no XML, incrementando automaticamente o índice da coluna. 

Se necessário, é possível informar a qual coluna determinado elemento pertence 
utilizando o atributo layout column. Porém, a ordem sequencial deve ser respei- 
tada, ou seja, não é possível incluir um elemento na coluna de índice 1 e depois um 
elemento na coluna de índice 0, nem via XML, nem programaticamente. Quando 
um número da sequência é omitido, o TableLayout assume que aquela é uma 
coluna vazia. Portanto, fazer uso do layout. column faz mais sentido quando de- 
sejamos incluir colunas vazias para criar espaço entre os elementos e possivelmente 
incluí-las no shrinkColumns. 

Agora, basta colocarmos os elementos que irão compor o layout e cada uma das 
colunas. Nas duas primeiras linhas da tabela, teremos a caixa de texto para que seja 
informado o destino e logo acima dela um TextView para o label do campo: 


<TextView android:text="Ostring/destino" /> 


<EditText 
android: id="@+id/destino" 
android: inputType="text" > 
</EditText> 


Em seguida, mais um TextView para o label do “Tipo da Viagem” e um 
RadioGroup que vai conter os RadioButton para fazer as opções como “Lazer” e 
“Negocios”. 


<TextView android:text="Ostring/tipo da viagem" /> 


<RadioGroup 
android:id="0+id/tipoViagem" 
android:orientation="horizontal" > 


<RadioButton 
android: id="@+id/lazer" 
android: checked="true" 
android: text="@string/lazer" /> 


<RadioButton 
android: id="@+id/negocios" 
android: layout_marginLeft="30dp" 
android: text="@string/negocios" /> 
</RadioGroup> 


74 


Casa do Código Capítulo 3. Domine os principais elementos de Interface Gráfica 





A seguir, temos mais uma linha que irá conter os labels para dois campos: “Data 
de Chegada” e “Data de Saída”. Como não queremos que cada elemento fique em 
uma linha e sim que os dois elementos ocupem a mesma, vamos envolvê-los num 
TableRow, onde cada um ocupará uma coluna: 


<TableRow> 


<TextView 
android:layout gravity="center" 
android:text="QOstring/data da chegada" /> 


<TextView 
android: layout_gravity="center" 
android:text="Ostring/data da saida" /> 
</TableRow> 


Logo abaixo do texto “Data de Chegada” e “Data de Saída” temos botões que 
serão utilizados para abrir caixas de diálogo específicas para seleção de datas, o 
DatePickerDialog. Também utilizaremos este widget na tela de registro de 
um novo gasto. Veremos como utilizá-lo na seção 3.4. Posteriormente, revisite a 
ViagemActivity para implementar esses dois itens. 


<TableRow> 


<Button 
android: id="0+id/dataChegada" 
android:onClick="selecionarData" 
android:text="QOstring/selecione" /> 


<Button 
android: id="@+id/dataSaida" 
android: onClick="selecionarData" 
android: text="@string/selecione" /> 
</TableRow> 


Por fim, montamos os campos para o valor do orçamento e quantidade de pes- 
soas, além de um botão para confirmar o cadastro da viagem: 


<TextView android:text="QOstring/orcamento" /> 


<EditText 
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android: id="@+id/orcamento" 
android: inputType="numberDecimal" /> 


<TableRow> 


<TextView 
android: layout_width="wrap_content" 
android: text="@string/quantidade_de_pessoas" /> 


<EditText 
android: id="@+id/quantidadePessoas" 
android: inputType="number" /> 
</TableRow> 


<Button 
android: onClick="salvarViagem" 
android: text="@string/salvar" /> 


Com o layout pronto, crie uma nova atividade chamada ViagemActivity 
e para abri-la precisamos adicionar a implementação correta do método 
selecionarOpcao da DashboardActivity. O código deste método será 


assim: 


public void selecionar0pcao (View view) 1 
switch (view.getId()) 1 
case R.id.nova viagem: 
startActivity (new Intent(this, ViagemActivity.class)); 
break; 


Quando um item for selecionado, este método será chamado recebendo como 
parâmetro a View que foi clicada. Utilizando o id da View saberemos qual item 
foi selecionado e então executaremos a ação desejada. Ao executar a aplicação no- 
vamente e selecionar o item “Nova Viagem” teremos como resultado uma tela seme- 


lhante à seguinte: 
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a il i 20h03 


Nova Viagem 
Destino 


ipo da viagem 


) Lazer (L) Negócios 


— 


Data da chegada Data da saída 


Selecione Selecione 


Orçamento 


No. de pessoas 


Criar nova viagem 





Figura 3.5: Tela de cadastro de uma nova viagem 


3.4 DATEPICKER 


O DatePicker é um widget projetado para a seleção de datas que pode ser utilizado 
tanto de maneira direta, incluindo-o diretamente no layout, como indireta, através 
de uma caixa de diálogo ( DatePickerDialog) apresentada para o usuário. 

Apesar de ser mais simples, a utilização direta do DatePicker não é comum, 
uma vez que o widget tem proporções exageradas, ocupando um espaço considerável 
na tela. Sua forma de uso mais comum é através do DatePickerDialog. 

Para exemplificar o seu uso e também dar prosseguimento à implementação da 
nossa aplicação, vamos desenvolver o layout e a atividade referentes ao registro de 
um novo gasto, de acordo com o protótipo da tela de cadastro dos gastos, como na 
figura 3.6. 
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3G mil 8:30 PM 


Tipo 


Valor Data 


R$ 21,90 12/4/2012 





Figura 3.6: Telas de cadastro de viagem e de gasto 


O arquivo XML de layout será o gasto.xml e a classe da atividade será a 
GastoActivity. O layout desta tela utiliza elementos que já conhecemos e é for- 
mado por um LinearLayout e um TableLayout, inseridos dentro de uma 
ScrollView, que vamos implementar aos poucos. 

Primeiro podemos fazer a parte superior da tela, com um “banner” escrito “Novo 
Gasto” e o nome do destino, para representar seu título. Para isto utilizaremos um 
LinearLayout aplicando uma cor diferente, com o atributo background, e in- 


cluiremos dois TextViews para as informações textuais: 


<?xml version="1.0" encoding="utf-8"?> 

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" > 


<LinearLayout 
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android: layout width="match parent" 


android: layout height="wrap content" 


android:orientation="vertical" > 


<LinearLayout 


android: layout width="match parent" 


android: layout height="wrap content" 
android: background="#015488" 
android:orientation="vertical" > 


<TextView 


android: 
android: 
android: 
android: 
android: 


android 


<TextView 


android: 


android 


android: 
android: 


android 


android 
</LinearLayout> 
</LinearLayout> 
</ScrollView> 


layout width="wrap content" 
layout height="wrap content" 
layout gravity="center" 
text="Ostring/novo gasto" 
textAppearance= 


"?android:attr/textAppearanceLarge" 


:textStyle="bold" /> 


id="@tid/destino" 


: Layout_width="wrap_content" 


layout_height="wrap_content" 
layout_gravity="center" 


: textAppearance= 


"?android:attr/textAppearanceLarge" 


:textStyle="bold" /> 


Em seguida, vamos fazer um TableLayout com duas linhas e duas colunas. 


Em cada coluna ficará um campo, no caso, na esquerda ficará o valor, e na direita, a 


data. Na linha de cima ficará a descrição e na linha inferior ficará o próprio campo. 


O campo para a data conterá apenas um botão, que ao ser clicado, irá disparar o 


método selecionarData da atividade que abre a caixa de diálogo para a seleção 


da data de realização do gasto. 


<?xml version="1.0" encoding="utf-8"?> 


<ScrollView ...> 
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<LinearLayout ...> 


<!-- Parte superior 


<TableLayout 


da tela --> 


android: layout width="match parent" 


android:layout height="wrap content" 


android: stretchColumns="0,1"> 


<TableRow> 


<TextView android:text="Ostring/valor" /> 


<TextView 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:text="Ostring/data" /> 
</TableRow> 
<TableRow> 
<EditText 
android: id="0+id/valor" 
android: layout width="wrap content" 
android:layout height="wrap content" 
android: inputType="numberDecimal" /> 
<Button 
android: id="0+id/data" 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:onClick="selecionarData" 
android: text="@string/selecione" /> 
</TableRow> 
</TableLayout> 
<!-- Mais campos virão aqui --> 
</LinearLayout> 
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</ScrollView> 


Para implementarmos a activity e fazê-la abrir a caixa de diálogo para a seleção 
da data corretamente, no método onCreate inicializamos três variáveis para repre- 
sentar o ano, mês e dia com base na data atual. Adicionalmente, alteramos o texto 
do botão para exibir a data atual e manter o usuário informado sobre a data que foi 


selecionada. 


public class GastoActivity extends Activity { 


private int ano, mes, dia; 
private Button dataGasto; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 
setContentView(R.layout.gasto) ; 
Calendar calendar = Calendar.getInstance() ; 


ano = calendar .get (Calendar. YEAR); 
mes = calendar.get (Calendar .MONTH) ; 
dia = calendar.get (Calendar.DAY OF MONTH); 


dataGasto = (Button) findViewById(R.id.data) ; 
dataGasto.setText(dia + "/" + (mes+1) + "/" + ano); 


O método selecionarData apenas invoca o método showDialog da pró- 
pria Activity passando um identificador que indica o diálogo que deve ser aberto. 
Esta identificação é necessária, pois podemos ter inúmeras diálogos gerenciados pela 
mesma activity. É comum encontrar códigos que fazem uso de constantes para repre- 
sentar os diálogos que serão abertos, no entanto, preferimos utilizar o identificador 
da própria view que deseja abrir o diálogo uma vez que ele já é único para o layout 
e já está declarado. 


public void selecionarData(View view){ 
showDialog(view.getId()); 


Quando o método showDialog é invocado para criar uma caixa de diálogo 
pela primeira vez, o método onCreateDialog é chamado, passando o identifica- 
dor informado, para que seja instanciado um novo DatePickerDialog. Se for 
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necessário executar alguma operação para alterar informações da caixa de diálogo 
sempre que ela for aberta, bastaria reescrever o método onPrepareDialog. 

Por fim, temos que implementar um listener que será responsável por tratar 
o resultado, ou seja, a data escolhida pelo usuário. Isso se faz através da defi- 
nição de uma classe anônima, que implementa OnDateSetListener, para o 
listener utilizado. Esta classe possui apenas um método que será invocado pelo 
próprio DatePickerDialog quando uma data for selecionada, que é o método 
onDateSet. 

Neste método devemos colocar nossas regras de negócio, como a criação de uma 
data ou atualização de uma já existente, algum tipo de validação para verificar se a 
data pertence a um período válido etc. Além disso é importante exibir para o usuá- 
rio, a título de informação, qual foi a data selecionada. Em nossa implementação, 
recuperamos os valores de ano, mês e dia informados e atualizamos o texto do botão 
para apresentar como resposta ao usuário. Agora já temos a seleção da data do gasto 


funcionando! 


@Override 
protected Dialog onCreateDialog(int id) { 
if(R.id.data == id){ 
return new DatePickerDialog(this, listener, ano, mes, dia); 


+ 


return null; 


private OnDateSetListener listener = new OnDateSetListener() 1 
@Override 
public void onDateSet (DatePicker view, 
int year, int monthOfYear, int dayOfMonth) { 


ano = year; 
mes = monthOfYear; 
dia = day0fMonth; 


dataGasto.setText(dia + "/" + (mes+1) + "/" + ano); 
F; 


Agora que as nossas datas funcionam e já permitimos a escolha dela, podemos 
voltar ao layout do gasto.xml. Ainda dentro do LinearLayout, adicionamos 
os dois campos para a descrição e o local e um botão para cadastrar o gasto: 


<TextView 
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android: 
android: 


android 


<EditText 


android: 
android: 
android: 
android: 


<TextView 


android: 
android: 
android: 


<EditText 


android: 


android 


android: 
android: 


<Button 


android: 
android: 


android 


android: 


layout width="wrap content" 
layout height="wrap content" 


:text="Qstring/descricao" /> 


id="@+id/descricao" 
layout width="match parent" 
layout height="wrap. content" 
inputType="text" /> 


layout width="wrap content" 
layout height="wrap. content" 
text="Ostring/local" /> 


id="0+id/local" 


“layout width="match parent" 


layout height="wrap content" 
inputType="text" /> 


layout width="match parent" 
layout height="wrap content" 


:onClick="registrarGasto" 


text="Qstring/gastei" /> 
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= wl E 15h15 3 E 15h16 = ow!) E 15h17 
Novo Gasto Novo Gasto 


segunda-feira, 16 de abril 
de 2012 


~ 


abr E 2012 


Gaste! Gastei! 


Definir Cancelar 
i 








Figura 3.7: Seleção de datas com DatePickerDialog 





CLASSES ANÔNIMAS 


Para os desenvolvedores que ainda não estão acostumados com a 
sintaxe do Java, é comum estranhar a definição de classes anônimas. 
Existem diversos artigos na internet que explicam como compreendê- 
las e quando usar, sendo que uma das explicações mais comenta- 
das está disponível no blog da Caelum, em http://blog.caelum.com.br/ 
classes-aninhadas-o-que-sao-e-quando-usar/ 











3.5 SPINNER 


Na tela de registro de gastos vamos incluir um widget para seleção de itens em uma 
lista suspensa. Conhecido em outras plataformas como combo box ou drop-down, 
no Android este widget é denominado de spinner. 

Na nossa aplicação, gostaríamos de classificar nossos gastos entre alimentação, 
hospedagem, combustível etc. Para isto, vamos declarar um spinner e especifica- 
remos o atributo android:prompt que representa o título que será apresentando 
quando a lista de opções for aberta. 


<TextView 
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android: layout width="wrap content" 
android: layout height="wrap content" 
android:text="0string/categoria" /> 


<Spinner 
android: id="0+id/categoria" 
android: layout width="match parent" 
android:layout height="wrap content" 
android: prompt="@string/categoria" > 
</Spinner> 


Note que na declaração do spinner não informamos quais são as opções dis- 
poniveis. Isto porque cada item do Spinner éuma view-filha que é proveniente 
deum SpinnerAdapter. Portanto devemos carregar os itens previamente em um 
SpinnerAdapter eatribui-loao spinner para que as opções possam ser exibidas. 

Já estão disponíveis na plataforma Android o ArrayAdapter e o 
SimpleAdapter que podem ser utilizados para criar os itens do spinner. 
Utilizaremos neste momento o ArrayAdapter que permite, por exemplo, carregar 
diretamente uma lista de opções definidas em um arquivo de recurso. Então, no 
arquivo strings.xml, definimos um array de strings com as categorias desejadas, 
da seguinte maneira: 


1 <string-array name="categoria gasto"> 


2 <item>Alimentação</item> 
3 <item>Combustível</item> 
4 <item>Transporte</item> 
5 <item>Hospedagem</item> 
6 <item>Outros</item> 


7 </string-array> 


No método onCreate da GastoActivity, criamos um novo 
ArrayAdapter e o atribuímos ao spinner de categorias conforme o código 
abaixo: 


1 private Spinner categoria; 

2 @Override 

3 protected void onCreate(Bundle savedInstanceState) { 
4 super .onCreate(savedInstanceState) ; 

5 setContentView(R.layout.gasto) ; 
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7 // busca a data atual para mostrar no botão 

8 

9 ArrayAdapter<CharSequence> adapter = ArrayAdapter.createFromResource( 
10 this, R.array.categoria gasto, 

u android.R.layout.simple spinner item); 

2 categoria = (Spinner) findViewById(R.id.categoria); 

13 categoria.setAdapter (adapter); 

4 } 


Para criar o ArrayAdapter utilizamos o método createFromResource, 





passando o contexto atual, o identificador do array de opções que definimos no 
strings.xml eo id do layout que será utilizado para apresentar as opções. Mais 
uma vez nos beneficiamos do que está disponível na plataforma e utilizamos o layout 
android.R.layout.simple spinner itemjá definido. Execute a aplicação e 
vejao spinner funcionando. 


% wl & 15h47 
Novo Gasto 


Data 


14/4/2012 


Categoria 


Alimentação 
Combustível 


Gastei! 





Figura 3.8: Uso do Spinner e SpinnerAdapter 
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3.6 LisTVIEWS 


Com as telas de criação de uma nova viagem e registro de gastos criadas, precisamos 
de alguma forma listar as viagens e gastos realizados para que possamos ver os deta- 
lhes e também realizar outras operações como editar e remover. Para implementar 
esta funcionalidade utilizaremos o widget List View que tem a capacidade de exibir 
itens em uma listagem. Os protótipos da nossa listagem de viagens e de gastos são 
os seguintes: 















3G ull 8:30 PM | 


36 all 8:30 PM 


Maceió Sanduiche R$ 19,90 

Táxi Aeroporto - Hotel R$ 34,00 
São Paulo Revista R$ 12,00 
Brasília 
Gramado 


Manaus 


Rio de Janeiro 





Figura 3.9: Listagens de viagens e gastos 


Ao acessar a opção Minhas Viagens, será apresentada uma lista de viagens ca- 
dastradas e ao selecionar um item da lista, o usuário poderá visualizar os gastos re- 
alizados naquela viagem em outra listagem. 

Como a necessidade de criar esses tipos de listagens é bastante frequente, a pla- 
taforma Android provê algumas facilidades para a sua criação através de um tipo es- 
pecial de atividade, a ListActivity. Esta classe já possui um widget ListView 
associado bastando que a ele seja atribuído um ListAdapter para prover os itens 
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que serão exibidos na lista, seguindo a mesma ideia do Spinner. Com isso, pode- 
mos inclusive utilizar um ArrayAdapter que além da interface SpinnerAdapter 
também implementa ListAdapter. 





Podemos então ter uma nova classe chamada ViagemListActivity que além 
de herdar de ListActivity, também implemente OnItemClickListener com 
o objetivo de tratar o evento disparado quando um item da lista é selecionado: 


public class ViagemListActivity extends ListActivity 
implements OnItemClickListener { 


No método onCreate, temos que criar um novo ArrayAdapter passando o 
layout desejado e os itens. Também recuperamos a ListView associada, através do 
método getListView que ganhamos por conta da herança. A essa ListView, 
atribuímos um listener que é a própria atividade, já que fizemos nossa classe imple- 
mentar OnItemClickListener. 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 


setListAdapter (new ArrayAdapter<String>(this, 
android.R.layout.simple list item 1, listarViagens())); 

ListView listView = getListView(); 

listView.setOnItemClickListener (this); 


private List<String> listarViagens() { 
return Arrays.asList("São Paulo", "Bonito", "Maceió"); 


Repare que utilizamos um layout padrão do Android, 
android.R.layout.simple list item 1, como o layout da linha da 
ListView. Além disso, é bem verdade que os itens da lista, ou seja, as viagens 
realizadas, deveriam estar armazenados em um banco de dados e serem recuperados 
de lá para exibição. No entanto, neste momento estamos preocupados apenas em 
montar as telas e as lógicas de navegação. Nos preocuparemos com persistência 
no próximo capítulo, quando revisitaremos esta atividade para incluir os códigos 
definitivos. 
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Quando uma viagem da lista for selecionada, gostaríamos de navegar para a 
lista de gastos realizados durante aquela viagem. Implementamos isto no mé- 
todo onItemClick, que é o método de OnItemClickListener invocado pela 
ListView quando um item é escolhido. Neste momento, apresentamos a descrição 
do item selecionado apenas para efeito de depuração e iniciamos a atividade refe- 


rente à listagem de gastos. 


@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 
TextView textView = (TextView) view; 
String mensagem = "Viagem selecionada: " + textView.getText() ; 


Toast.makeText (getApplicationContext(), mensagem, 
Toast .LENGTH_SHORT) .show() ; 
startActivity(new Intent(this, GastoListActivity.class)); 


Para esta listagem de gastos, precisaremos criar outra atividade, a 
GastoListActivity, que será bastante similar à que acabamos de implementar, 


veja: 


public class GastoListActivity extends ListActivity 
implements OnItemClickListener { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 


setListAdapter(new ArrayAdapter<String>(this, 
android.R.layout.simple_list_item_1, listarGastos())); 

ListView listView = getListView() ; 

listView.setOnItemClickListener (this); 


GOverride 
public void onItemClick(AdapterView<?> parent, View view, 
int position, long id) { 
TextView textView = (TextView) view; 
Toast .makeText(this,"Gasto selecionado: " + textView.getText(), 
Toast .LENGTH_SHORT) .show() ; 
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22 private List<String> listarGastos() { 

23 return Arrays.asList("Sanduíche R$ 19,90", 

24 "Táxi Aeroporto - Hotel R$ 34,00", 
25 "Revista R$ 12,00"); 

26 } 

ay + 


Novamente utilizamos um ArrayAdapter e um método para simular a re- 
cuperação dos itens que devem ser exibidos. Independentemente da viagem que 
foi escolhida, os gastos apresentados são sempre os mesmos. Não se preocupe com 
isso agora, pois iremos refatorar esses códigos e fazer o carregamento dos gastos de 
acordo com a viagem selecionada, diretamente do banco de dados. Ao executar a 
atividade ViagemListActivity e escolher um item da lista, teremos o seguinte 


resultado: 


= 


São Paulo Sanduíche R$ 19,90 


Bonito Taxi Aeroporto - Hotel R$ 34,00 


Maceió Revista R$ 12,00 





Figura 3.10: Listagem de viagens e gastos 


Apesar de ter sido simples de implementar e serem plenamente funcionais, nos- 
sas listagens não têm um visual elegante. Mas isto não é um problema, pois podemos 
customizar nossas ListViews e deixá-las com uma aparência mais rica. O que fa- 
remos agora é incluir uma imagem para diferenciar o tipo da viagem assim como 
incluir informações do período e o total dos gastos realizados. Para a listagem de 
gastos destacaremos as categorias com cores diferentes e faremos um agrupamento 


por data. O protótipo a seguir serve como referência para implementação: 
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36 ull 8:30 PM | 36 ull 8:30 PM 


Bonito 
02/02/2012 a 09/02/2012 
Gasto total: R$ 3.247,80 


SGo Paulo 
ry 04/03/2012 a 05/03/2012 
Gasto total: R$ 193,75 





Figura 3.11: Prototipo de listagens personalizadas 


Anteriormente fizemos uso da ListActivity que já possui uma ListView 
associada, cujo layout consiste simplesmente de um TextView. Para listagens 
personalizadas precisamos definir um layout conforme o desejado e atribuí-lo à 
ListView. Para isso, crie um novo arquivo XML de layout com o nome de 
lista viagem.xml. 

Nesse layout, vamos adicionar um LinearLayout com orientação horizontal, 
pois nossa tela é dividida em um lado, esquerdo, para a imagem e outro lado para os 
dados da viagem. 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="horizontal"> 


<!-- adicionaremos os outros componentes aqui --> 
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</LinearLayout> 


No primeiro elemento dentro desse layout horizontal, faremos um outro 
LinearLayout dessa vez com orientação vertical, onde teremos a imagem de 
acordo com o tipo da viagem. 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout ...> 
<LinearLayout 
android:layout width="wrap content" 
android:layout height="match parent" 
android:gravity="center" 
android:orientation="vertical" > 


<ImageView 
android: id="0+id/tipoViagem" 
android: layout width="wrap content" 
android:layout height="wrap content" /> 
</LinearLayout> 


<!-- 
ainda faltam aqui os componentes do lado direito 


com os dados das viagens 
--> 


</LinearLayout> 


E para finalizar, outro LinearLayout com orientação vertical com 3 
TextView para mostrar o destino, data e gasto da viagem. 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout ...> 


<!-- aqui esta o LinearLayout com a ImageView dentro --> 


<LinearLayout 
android: layout_width="wrap_content" 
android:layout height="match parent" 
android: layout marginLeft="10dp" 
android:orientation="vertical" > 
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<TextView 
android: id="0+id/destino" 
android: layout width="wrap content" 
android:layout height="wrap content" /> 


<TextView 
android: id="0+id/data" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 


<TextView 
android: id="@t+tid/valor" 
android: layout_width="wrap_content" 
android:layout height="wrap content" /> 
</LinearLayout> 


</LinearLayout> 


Quando se trabalha com listagens personalizadas é importante definir o identi- 
ficador dos widgets que irão exibir a informação pois será necessário manipulá-los 
na activity. Repare que não definimos nenhum texto para os TextViews e 
nem uma imagem para o ImageView pois seus valores serão definidos em tempo 
de execução, de acordo com a linha a ser exibida. 


Naclasse ViagemListActivity iremos substituiro ArrayAdapter que usa- 





mos no método onCreate, que não suporta o layout customizados que definimos, 
por um SimpleAdapter. Este adapter é bastante versátil, pois permite fazer uma 
correlação entre os dados e os widgets que devem exibi-los, permitindo o uso de 
layouts arbitrários, tanto em ListViews quanto em Spinners. 

Para criar um SimpleAdapter é necessário informar um Array de String 
com as chaves que serão utilizadas para recuperar os dados, juntamente de 
um outro Array com os identificadores dos widgets (os mesmos definidos no 
lista viagem.xml) que exibirão os dados. Os elementos dos arrays são cor- 
relacionados, ou seja, os dados armazenados com a chave “imagem” devem ser exi- 
bidos pelo widget com identificador R.id.tipoViagem. Dessa forma, o método 
onCreate será modificado para ficar como: 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
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super .onCreate (savedInstanceState); 


String[] de = {"imagem", "destino", "data", "total"}; 
int [] para = {R.id.tipoViagem, R.id.destino, R.id.data, R.id.valor}; 


SimpleAdapter adapter = 
new SimpleAdapter(this, listarViagens(), 
R.layout.lista_viagem, de, para) ; 


setListAdapter (adapter) ; 


getListView() .setOnItemClickListener (this); 


É preciso alterar o método listarViagens para retornar uma lista que será 
utilizada pelo SimpleAdapter com as informações a serem exibidas. A lista é for- 
mada por um conjunto de mapas, cujas chaves devem ser os identificadores definidos 
no String[] de. 


public class ViagemListActivity extends ListActivity 
implements OnItemClickListener { 


private List<Map<String, Object>> viagens; 


private List<Map<String, Object>> listarViagens() { 
viagens = new ArrayList<Map<String,Object>>(); 


Map<String, Object> item = new HashMap<String, Object>(); 
item.put("imagem", R.drawable.negocios) ; 
item.put("destino", "São Paulo"); 

item.put("data" "02/02/2012 a 04/02/2012"); 
item.put("total","Gasto total R$ 314,98"); 
viagens.add(item) ; 


item = new HashMap<String, Object>(); 
item.put("imagem", R.drawable.lazer) ; 
item.put("destino", "Maceió"); 

item. put ("data" "14/05/2012 a 22/05/2012"); 
item. put("total","Gasto total R$ 25834,67"); 
viagens .add(item) ; 
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return viagens; 


Observe também que incluímos para a chave imagem o valor 
R.drawable.negocios que é o identificador da imagem que deve ser utili- 
zada pelo ImageView, mapeado no int [] para como R.id.tipoViagem. 
Lembre-se de ter as imagens no seu diretório drawable. 

O SimpleAdapter, em tempo de execução, decide como fazer o bind dos dados 
informados de acordo com o tipo de view fornecido. Os widgets suportados pelo 
SimpleAdapter são aqueles que implementam a interface Checkable, como o 
TextVieweo ImageView. No entanto, é possível fazer a atribuição de dados para 
outros tipos de views, implementando um ViewBinder. Faremos algo assim para 
a listagem de gastos. 

Por fim, faltou apenas ajustar o método onItemClick para recuperar a viagem 
de acordo com a posição selecionada na tela e exibir através do Toast .makeText 
uma informação sobre essa viagem. Com isso, o código do método ficará: 


public class ViagemListActivity extends ListActivity 
implements OnItemClickListener ( 
private List<Map<String, Object>> viagens; 


@Override 
public void onItemClick(AdapterView<?> parent, 
View view, int position, long id) { 
Map<String, Object> map = viagens.get (position) ; 
String destino = (String) map.get ("destino"); 
String mensagem = "Viagem selecionada: "+ destino; 
Toast .makeText (this, mensagem, Toast .LENGTH_SHORT) .show() ; 
startActivity(new Intent(this, GastoListActivity.class)); 


// métodos listarViagens e onCreate 


Agora se executarmos a aplicação vamos ter a listagem personalizada de viagens. 
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a!) A 
São Paulo 
02/02/2012 a 04/02/2012 


Gasto total R$ 314,98 
Maceió 

14/05/2012 a 22/05/2012 
Gasto total R$ 25834,67 





Figura 3.12: Lista de viagens personalizada 


A versão personalizada da listagem de gastos deve exibir os itens da lista em cores 
diferentes, de acordo com a categoria. Além disso, os gastos devem estar agrupados 
por data, para melhorar a organização e a usabilidade. 

Continuaremos utilizando o SimpleAdapter para alimentar a ListView e 
criaremos uma implementação da interface ViewBinder para realizar o bind entre 
os dados e os widgets do layout da forma que desejamos. 

O ViewBinder será o responsável por identificar quais gastos são da mesma 
data e exibir um separador na ListView para agrupá-los. Além disso, de acordo 
com a categoria, o ViewBinder irá alterar a cor de fundo do item da listagem. 
Vamos criar um novo layout no arquivo lista gasto.xml coma definição de um 
LinearLayout com orientação vertical, que conterá um TextView para mostrar 
a data da viagem: 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: background="@color/titulo" 
android: orientation="Vvertical" > 


<TextView 
android: id="@+id/data" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout_gravity="right" 
android: textColor="@android: color/white"/> 


</LinearLayout> 
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Vale ressaltar novamente que, como precisaremos manipular os widgets via có- 
digo Java, é necessário que os mesmos possuam um id, inclusiveo LinearLayout 
pois a sua cor de fundo será alterada em tempo de execução de acordo com a cate- 
goria. 

Por fim, adicionamos também outro LinearLayout com dois TextView para 
exibir a descrição e o custo da viagem: 


<LinearLayout ...> 
<!-- TextView para a data --> 


<LinearLayout 
android: id="0+id/categoria" 
android: layout width="match parent" 
android: layout height="match parent" 
android:orientation="vertical" > 


<TextView 
android: id="@+id/descricao" 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:textColor="Qandroid:color/black" /> 


<TextView 
android: id="@+id/valor" 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:textColor="Qandroid:color/black" /> 
</LinearLayout> 


</LinearLayout> 


Para manter nosso código organizado e para facilitar alterações posteriores, ire- 
mos externalizar o esquema de cores utilizado na listagem, assim como fazemos 
com as strings. O Android permite a utilização e definição de cores em arqui- 
vos de recurso. Então, vamos criar no diretório res/values um arquivo chamado 
colors.xml. As cores foram definidas da seguinte maneira: 


1 <?eml version="1.0" encoding="utf-8"?> 
2 <resources> 


3 
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<color name="titulo">#015488</color> 

<color name="categoria_alimentacao">#9FC5F8</color> 
<color name="categoria_hospedagem">#6FA8DC</color> 
<color name="categoria_transporte">#0099CC</color> 
<color name="categoria_outros">#ACBFD5</color> 


10 </resources> 








NOME DO ARQUIVO DE CORES 


Não existe uma regra sobre o nome do arquivo ser colors.xml, 
vocé poderia usar qualquer outro nome. No entanto, é convencionado 
que um arquivo que contenha a definição das cores a serem usadas numa 
aplicação Android terá esse nome. 





As cores estão no formato RGB codificadas em hexadecimal. O nome atribuído 


Casa do Código 





à cor se tornará o seu identificador, sendo possível acessá-la via classe R, como por 


exemplo, R.color.categoria alimentacao. Vale lembrar que, assim como 


as strings e drawables, as cores devem ser acessadas via a API de recursos do 
Android. 


Começamos criando os Arrays dentro do método onCreate para utilizarmos 


o SimpleAdapter também na GastoListActivity 


public class GastoListActivity extends ListActivity 
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implements OnItemClickListener { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super .onCreate(savedInstanceState) ; 
String[] de = { "data", "descricao", "valor", "categoria" }; 
int[] para = { R.id.data, R.id.descricao, 
R.id.valor, R.id.categoria }; 
SimpleAdapter adapter = new SimpleAdapter (this, 


listarGastos(), R.layout.lista_gasto, de, para); 


setListAdapter (adapter) ; 
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getListView().setOnItemClickListener(this); 


Agora precisamos da implementação do método listarGastos, que devolve 
uma lista contendo mapas com as propriedades a serem usadas: 


public class GastoListActivity extends ListActivity 
implements OnItemClickListener { 


private List<Map<String, Object>> gastos; 
// método onCreate aqui 


private List<Map<String, Object>> listarGastos() { 
gastos = new ArrayList<Map<String, Object>>(); 


Map<String, Object> item = new HashMap<String, Object>(); 
item.put("data", "04/02/2012") ; 

item.put("descricao", "Diária Hotel"); 

item.put("valor", "R$ 260,00"); 

item.put("categoria", R.color.categoria_hospedagem) ; 
gastos.add(item) ; 


// pode adicionar mais informações de viagens 


return gastos; 


E o método onItemClick usando a nova lista de gastos para exibir a informa- 
ção quando clicada. 


public class GastoListActivity extends ListActivity 
implements OnItemClickListener { 


// atributos, método onCreate e listarGastos 
@Override 
public void onItemClick(AdapterView<?> parent, View view, 


int position, long id) { 
Map<String, Object> map = gastos.get (position); 
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String descricao = (String) map.get("descricao"); 
String mensagem = "Gasto selecionada: " + descricao; 
Toast .makeText (this, mensagem,Toast.LENGTH SHORT). show(); 


Agora, só nos resta fazer 0 ViewBinder, que ficará responsável por identificar 
os gastos da mesma data, exibir o separador na ListView para termos o agrupa- 
mento e mudar a cor de fundo do item da listagem. 

A criação do ViewBinder é feita através de uma nova classe que implemente 
essa interface na qual se deverá implementar o método setViewValue. Ele retorna 
um boolean e é chamado pelo SimpleAdapter para cada elemento da lista in- 
formada em sua criação. Para ele, são passados três parâmetros: 


e View - recuperada a partir de um id passado no String para[]; 


e Object - que é o valor armazenado com a chave equivalente ao String 
de []. 


e String - uma representação em formato texto do dado passado ( object 
data), que sera ou o resultado do método toString() ou uma String 
vazia, sendo garantido que seu valor jamais será nulo. 


Portanto, podemos criar uma classe nova, privada, em GastoListActivity, 
que herde de ViewBinder: 


public class GastoListActivity extends ListActivity 
implements OnItemClickListener { 


// atributos, método onCreate, listarGastos e onItemClick 
private class GastoViewBinder implements ViewBinder { 
@Override 
public boolean setViewValue(View view, Object data, 


String textRepresentation) { 
// vamos implementar esse método 
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Este método deve retornar true caso o bind tenha sido realizado. Caso o re- 
torno seja false,0 SimpleAdapter tentará realizar o bind automaticamente para 





os tipos de views suportados ( Checkable, TextViewe ImageView). Se não for 








possível realizar o bind uma IllegalStateException será lançada. 

Para fazermos o agrupamento, temos que verificar qual éa View que está sendo 
processada. 

Caso seja a data do gasto, então precisamos comparar também se este gasto foi 
realizado na mesma data processada anteriormente ou se foi em uma nova data. 
Sendo uma data diferente da anterior, então devemos exibir o separador, que na 
verdade é apenas um TextView cujo valor é a data do gasto. Caso sejam iguais, 
ou seja, os gastos foram realizados na mesma data, então temos que suprimir o 
TextView com view.setVisibility (View.GONE), dando a impressão de 








agrupamento. Outra opção de visibilidade é a View. INVISIBLE porém, diferen- 





temente do View.GONE, a view não é exibida mas continua ocupando lugar no 
layout. 

A segunda comparação trata do LinearLayout que engloba todas as infor- 
mações dos gastos e se refere à categoria. Neste caso, o dado passado para o mé- 
todo é o próprio identificador da cor que deve ser utilizada como cor de fundo do 


LinearLayout 


public class GastoListActivity extends ListActivity 
implements OnItemClickListener { 


// atributos, método onCreate, listarGastos e onItemClick 


private String dataAnterior = ""; 


private class GastoViewBinder implements ViewBinder { 


@Override 
public boolean setViewValue(View view, Object data, 
String textRepresentation) { 


if(view.getId() == R.id.data){ 
if (!dataAnterior.equals (data) ){ 
TextView textView = (TextView) view; 
textView. setText (textRepresentation) ; 
dataAnterior = textRepresentation; 
view.setVisibility (View. VISIBLE) ; 
} else { 
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view.setVisibility(View.GONE) ; 
} 


return true; 


if(view.getId() == R.id.categoria){ 
Integer id = (Integer) data; 
view. setBackgroundColor (getResources() .getColor(id)); 
return true; 


} 


return false; 


Por fim, agora basta indicarmos no método onCreate da 
GastoListActivity que o adapter usará o ViewBinder que acabamos 
de criar. Fazemos isso através do método setViewBinder do adapter. 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 


String[] de = { "data", "descricao", "valor", "categoria" }; 
int[] para = { R.id.data, R.id.descricao, 


R.id.valor, R.id.categoria }; 


SimpleAdapter adapter = new SimpleAdapter(this, listarGastos(), 
R.layout.lista_gasto, de, para); 


adapter. setViewBinder (new GastoViewBinder ()); 


setListAdapter (adapter); 
getListView() .setOnItemClickListener (this) ; 
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x% ul É 21h42 
04/02/2012 





Wifi 
R$ 7,00 





Sanduíche 
R$ 19,90 





Figura 3.13: Lista personalizada de gastos 


3.7 MENUS 


Os menus, da mesma maneira que os dialogs como 0 DatePickerDialog, são ele- 
mentos importantes de interação com o usuário do aplicativo e podem ser utilizados 
para lhe apresentar opções que podem ser tanto globais, quando dizem respeito a 
uma configuração ou estado da aplicação, ou contextuais quando a opção está rela- 
cionada com algum item selecionado, por exemplo. 

Até a versão 3.0 do Android, era obrigatório que os aparelhos tivessem um botão 
menu, que quando pressionado apresentava um painel com no máximo seis opções 
visíveis. Quando existiam mais de seis opções, era necessário selecionar uma opção 
“mais itens” para visualizar o que restava. Este tipo de menu é conhecido como op- 
tions menu. Nos aparelhos mais recentes já não existe mais o botão menu e muito 
menos botões físicos, exceto os de volume e para ligar o aparelho. 
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Menu de opções 


Geralmente os options menu são utilizados para apresentar opções que são rele- 


vantes para a activity atual ou para a aplicação. Criaremos então alguns menus de 


opção para algumas de nossas atividades. 


Podemos começar pela DashboardActivity, onde vamos criar um menu 


com a opção de sair da aplicação. Em seguida, para a ViagemActivity criare- 


mos um menu com a opção de registrar um novo gasto e apagar a viagem. Já para a 


GastoActivity colocaremos um menu com a opção de remover o gasto. 


= 4 8 17h27 =d = w 
BoaViagem Nova Viagem Novo Gasto 


a = 


Novo Gasto Nova Viagem 


is 


Minhas Viagens Configurações 





Figura 3.14: Menus de opções 


Os menus são definidos em arquivos XML específicos com o objetivo de externa- 


lizar a estrutura do menu do código da aplicação, além de permitir que sejam defini- 


dos 


diferentes menus para suportar diferentes configurações de aparelhos e versões 


do Android. Os arquivos de menu devem ficar no diretório res /menu. Então va- 


mos lá, vamos criar o menu para o Dashboard no arquivo dashbord menu.xml, 


com a seguinte definição: 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
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android: id="@t+tid/sair" 
android: icon="@android:drawable/ic_menu_close_clear_cancel" 
android: title="@string/sair"/> 


</menu> 


O elemento raiz do XML é o menu que pode conter várias tags item que repre- 
sentam as opções do menu. Um item pode ter um 

Os menus são efetivamente criados pela activity que está ativa quando 
o botão menu é pressionado, e nesse momento, invoca-se o método 
onCreateOptionsMenu. A própria activity também fornece um método 





para tratar quando um item do menu for selecionado, o onMenuItemSelected. 
Vamos começar pela implementação do onCreateOptionsMenu. 

O método onCreateOpt ionsMenu recebe como parâmetro um objeto do tipo 
Menu, no qual precisamos popular as opções de acordo com as informações do XML 
que acabamos de criar, que se encontra dentro de res /menus. Para isso, é preciso 
passar os dados do XML para o objeto recebido como parâmetro, que é justamente 
o papel de uma classe chamada MenuInflater. 

Recuperamos uma instância dela através da chamada ao método 
getMenuInflater para, em seguida, invocar seu método inflate, pas- 
sando como parâmetro uma referência para o menu através da classe R e também o 
objeto menu. Por fim, retornamos true para indicar que o menu deve ser exibido. 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
Menulnflater inflater = getMenulnflater(); 
inflater.inflate(R.menu.dashboard_menu, menu) ; 
return true; 


Como nosso menu só tem uma opção, que no caso é sair da aplicação, 
não precisamos saber qual foi o item selecionado, então a implementação do 





onMenultemSelected apenas invoca o método finish para encerrar a atividade 
atual. Posteriormente, neste método também implementaremos o logoff do usuário. 


COverride 

public boolean onMenultemSelected(int featureId, Menultem item) { 
finish(); 
return true; 
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Paraa ViagemActivity, que é a tela utilizada para criar e editar viagens, te- 
remos um options menu com as opções de registrar um novo gasto ou remover a 
viagem. Crie o arquivo viagem menu .xm1 com a definição abaixo: 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android" > 


<item 
android: id="@+id/novo_gasto" 
android: icon="@android: drawable/ic_menu_add" 
android: title="Qstring/novo_gasto"/> 

<item 
android: id="@+id/remover" 
android: icon="@android:drawable/ic_menu_delete" 
android: title="Qstring/remover_viagem"/> 


</menu> 


Como neste menu temos mais de uma opção, é essencial definir identificadores 
para os seus itens para que se possa determinar qual foi o item selecionado. Para 
começar, faremos no onCreateOpt ionsMenu a mesma transformações dos dados 
do XML para o objeto Menu. 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
Menulnflater inflater = getMenuInflater() ; 
inflater.inflate(R.menu.viagem_menu, menu) ; 
return true; 


No método onMenuItemSelected com base no id do item selecionado de- 





cidimos a ação a ser executada. Quando a opção for referente ao novo gasto, iremos 
iniciar a atividade GastoActivity e quando for a de remover, iremos excluir a vi- 
agem atual. Caso não seja possível determinar qual item foi selecionado, invocamos 
a implementação padrão do método que retorna false. 


@Override 
public boolean onMenultemSelected(int featureId, Menultem item) { 
switch (item.getItemId()) { 
case R.id.novo_gasto: 
startActivity(new Intent(this, GastoActivity.class)) ; 
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return true; 
case R.id.remover: 
//remover viagem do banco de dados 
return true; 
default: 
return super.onMenultemSelected(featureld, item); 


Caso queira exercitar, crie por conta própria um menu com a opção de remover 
gasto paraa GastoActivity, a implementação será semelhante às realizadas até 
o momento. 

Nos options menus ainda há a possibilidade de agrupar itens através da tag 
group e também de criar submenus, aninhando a tag menu. Os grupos servem 
para facilitar o controle de itens que são relacionados. Através de grupos é possi- 
vel definir a visibilidade de todos os seus itens, ou se estão ativos ou não. O código 
abaixo retirado da documentação do Android exemplifica o uso de grupos: 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas. android. com/apk/res/android"> 
<item android: id="0+id/menu save" 
android: icon="@drawable/menu_save" 
android:title="Ostring/menu save" /> 
<!-- menu group --> 
<group android: id="0+id/group delete"> 
<item android:id="0+id/menu archive" 
android:title="Qstring/menu archive" /> 
<item android: id="0+id/menu delete" 
android:title="Qstring/menu delete" /> 
</group> 
</menu> 


Os submenus podem ser criados simplesmente incluindo uma nova tag menu 
com seus itens associados. Isso é útil quando nossa aplicação tem um conjunto 
grande de opções que podem ser agrupadas em assuntos. Porém tenha cuidado ao 
utilizar menus com muitos níveis para não prejudicar a usabilidade da aplicação. Um 
exemplo de submenu retirado também da documentação do Android é o seguinte: 


<?xml version="1.0" encoding="utf-8"?> 


n 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 


N 
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3 <item android: id="@+id/file" 

4 android:title="Ostring/file" > 

5 <!-- "file" submenu --> 

6 <menu> 

7 <item android: id="@+id/create_new" 

8 android: title="@string/create_new" /> 
9 <item android: id="@+id/open" 

10 android:title="@string/open" /> 
n </menu> 

2 </item> 

3 </menu> 


Menus Contextuais 


Em aparelhos Android, quando queremos reenviar uma mensagem SMS para a 
pessoa caso ela não tenha recebido ou tenha havido falha no envio, não é necessário 
ter o trabalho de redigitar essa mensagem completamente. O próprio aplicativo de 
mensagens do Android nos permite reenviar uma mensagem específica segurando 
sobre ela e escolhendo em um menu a opção para realizar o reenvio. Esse menu que 
surge e é específico para aquela mensagem é o que chamamos de “Menu de Contexto”, 
veja um exemplo na imagem 3.15. 
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Opções de mensagem 


Copiar texto 


Encaminhar 


Bloquear 


Visualizar detalhes 


Excluir 





Figura 3.15: Menu de contexto 


O menus contextuais oferecem ao usuário opções que são relevantes ao con- 
teúdo que está sendo apresentado. Por exemplo, ao selecionar um item de uma 
ListView, podemos apresentar um menu de contexto com opções que fazem sen- 
tido para aquele item, tais como visualizar, editar, compartilhar etc. 

Para a nossa listagem de gastos, criaremos um menu contextual que permi- 
tirá ao usuário remover o gasto selecionado. A criação deste tipo de menu é si- 
milar ao que já realizamos para o menu de opções. Devemos definir um ar- 
quivo XML contendo as opções do menu, construir as opções do menu sobrescre- 
vendo o método onCreateContextMenu e tratar a seleção do usuário no método 
onContextItemSelected. 








A única diferença, além do nome dos métodos, é a necessidade de registrar 
a View que irá apresentar o menu de contexto, que fazemos através do método 





registerForContextMenu (View view). Então, no método onCreate da 
GastoListActivity, vamos registrar o menu de contexto. 


@Override 
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protected void onCreate (Bundle savedInstanceState) { 
super .onCreate(savedInstanceState) ; 


String[] de = { "data", "descricao", "valor", "categoria" }; 
int[] para = { R.id.data, R.id.descricao, 
R.id.valor, R.id.categoria }; 


SimpleAdapter adapter = new SimpleAdapter(this, listarGastos(), 
R.layout.lista_gasto, de, para) ; 


setListAdapter (adapter) ; 
getListView() .setOnItemClickListener (this); 


// registramos aqui o novo menu de contexto 
registerForContextMenu(getListView()); 


Para a nossa listagem de gastos, como a única opção disponível no menu de 
contexto será a de remover, criaremos um novo XML de layout com o nome de 


gasto menu.xml: 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android" > 
<item 
android: id="@+id/remover" 
android: icon="@android:drawable/ic_menu_delete" 
android: title="Qstring/remover"/> 
</menu> 


Fazemos o método onCreateContextMenu para ler as opções do XML e 





transformá-las em um objeto do tipo ContextMenu: 


OOverride 
public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenulnfo menulnfo) { 
Menulnflater inflater = getMenulnflater(); 
inflater. inflate(R.menu.gasto menu, menu); 


Em seguida, precisamos reescrever o método onContextItemSelected, que 





recebe o item do menu que foi selecionado, para realizarmos a ação adequada, no 
caso, fazer a remoção. 
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Para recuperar informações sobre o item do menu que foi selecionado, uti- 
lizamos o método item.getMenuInfo() que retorna um objeto do tipo 
AdapterContextMenuInfo, que fornece o id da linha que foi selecionada, a po- 
sição do item no adapter ea view que foi selecionada. 

Com isso, utilizamos a informação da posição para remover o item da lista de 
gastos. No entanto, essa operação não é refletida automaticamente na ListView 
que já renderizou as linhas na tela. É necessário fazer com que a ListView desenhe 
as linhas novamente com base no adapter que agora tem um item a menos. Isto é 


feito invocando o método invalidateViews (). 


@Override 
public boolean onContextItemSelected (Menultem item) { 


if (item.getItemId() == R.id.remover) { 
AdapterContextMenulnfo info = (AdapterContextMenulnfo) item 
.getMenuInfo() ; 
gastos.remove(info.position) ; 
getListView() .invalidateViews() ; 


dataAnterior = ""; 


// remover do banco de dados 
return true; 


+ 


return super.onContextItemSelected(item); 


Pronto, agora temos a nossa aplicação com o menu de contextos funcionando. 
Em breve, integraremos com o banco de dados de verdade. 


3.8 ALERTDIALOG 


Além dos menus, podemos apresentar opções para o usuário através de caixas de 
diálogo que são utilizadas geralmente para interagir com o usuário, apresentando 
algum tipo de informação e solicitando que ele decida o que deve ser feito. 

Podemos utilizar, por exemplo, uma caixa de diálogo solicitando ao usuário a 
confirmação da exclusão de uma informação ou exibir uma mensagem de que de- 
terminada ação foi realizada. Os AlertDialogs podem conter até três botões ou 
ainda uma lista de itens selecionáveis através de checkboxes ou radio buttons, tor- 
nando variadas as formas de interação com o usuário. A imagem 3.16 exemplifica o 
uso de uma caixa de diálogo para confirmar a exclusão de uma foto. 


111 


3.8. AlertDialog Casa do Código 





Excluir o item selecionado? 


Cancelar OK 





Figura 3.16: AlertDialog 


Na nossa aplicação, quando o usuário selecionar uma viagem na listagem “Mi- 
nhas Viagens”, queremos apresentar as opções de editar, registrar um novo gasto, 
visualizar os gastos já realizados e remover a viagem selecionada. Como já vimos 
anteriormente, poderíamos criar um menu de contexto para resolver essa questão. 

No entanto, para abrir o menu de contexto o usuário precisa selecionar um item 
e mantê-lo pressionado até a exibição das opções, o que torna a interação mais lenta 
e, em se tratando de funcionalidades que serão muito utilizadas, pode acabar preju- 
dicando a usabilidade. Seria melhor se, ao selecionar um item da lista, o menu de 
opções fosse imediatamente apresentado. Este comportamento é obtido implemen- 


tando o menu com as opções como uma caixa de diálogo. 





O AlertDialog é criado através de um AlertDialog.Builder, no qual 
informaremos o título da caixa de diálogo e os seus itens. Também é necessário 
fornecerum OnClickListener para tratar da opção escolhida pelo usuário. Nossa 





ViagemListActivity já implementa a interface OnItemClickListener para 
capturar o clique de um item na ListView e agora deverá implementar a interface 
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OnClickListener e seu método onClick para tratar a opção selecionada pelo 
usuário na caixa de diálogo. 


public class ViagemListActivity extends ListActivity 
implements OnItemClickListener, OnClickListener { 


@Override 
public void onClick(DialogInterface dialog, int item) { 
// Vamos implementar esse método 


Agora vamos criar um método chamado criaAlertDialog, onde definire- 
mos um Array com as opções que serão exibidas na caixa de diálogo. Esse método 
retornará 0 AlertDialog construído com as opções. 


private AlertDialog criaAlertDialog() | 
final CharSequence[] items = { 
getString(R.string.editar), 
getString(R.string.novo gasto), 
getString(R.string.gastos realizados), 
getString(R.string.remover) +; 


AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(R.string.opcoes); 


builder.setItems(items, this); 


return builder.create(); 


Agora, quando a ViagemListActivity% for criada, é preciso adicionar o 





AlertDialog também, assim, poderemos usá-lo quando for necessário. Para isso, 
vamos acrescentar uma chamada ao criaAlertDialogno onCreate da activity: 


protected void onCreate(Bundle savedInstanceState) { 
// Realiza as outras ações 


this.alertDialog = criaAlertDialog() ; 


Guardamos a referência para o dialog criado, num atributo de instância da 
ViagemListActivity que chamamos de alertDialog. 
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public class ViagemListActivity extends ListActivity 
implements OnItemClickListener, OnClickListener { 


private AlertDialog alertDialog; 


// outros atributos e métodos 


No método sobrescrito onClick, utilizaremos o índice do Array dos itens do 
AlertDialog para determinar qual opção foi selecionada e executaremos a ação 
apropriada. Para que o AlertDialog funcione de forma similar a um menu de 
contexto e também tenha a opção para realizar a exclusão da viagem, precisaremos 
manter uma referência para o item da ListView que foi selecionado. Isso é feito 
no método sobrescrito onItemClick, que armazena a posição do item selecionado 
e só então abre a caixa de diálogo invocando alertDialog.show(). Quando a 
opção “remover” da caixa de diálogo é selecionada, utilizamos a posição previamente 


armazenada para remover a viagem da ListView. 


@Override 
public void onClick(DialogInterface dialog, int item) { 
switch (item) { 
case 0: 
startActivity(new Intent(this, ViagemActivity.class)); 
break; 
case 1: 
startActivity(new Intent(this, GastoActivity.class)) ; 
break; 
case 2: 
startActivity(new Intent(this, GastoListActivity.class)); 
break; 
case 3: 
viagens.remove(this.viagemSelecionada) ; 
getListView() .invalidateViews() ; 
break; 


@Override 

public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 
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24 this.viagemSelecionada = position; 
25 alertDialog.show() ; 
26 } 


Note que precisamos ter um novo atributo na ViagemListActivity para 





guardar a viagem selecionada. 


private int viagemSelecionada; 


Pronto. Agora temos uma versão de menu de contexto muito mais responsiva. 
Execute a aplicação e confira! 


Editar 


Novo Gasto 


Gastos realizados 


Remover 





Figura 3.17: Menu utilizando AlertDialog 


AlertDialogs com confirmações 


Geralmente operações críticas da aplicação requerem a confirmação do usuá- 
rio. É o caso por exemplo da exclusão de uma viagem ou de um gasto realizado. As 
caixas de diálogo de confirmação, com botões “sim/não”, são implementadas utili- 
zando AlertDialogs. Vamos alterar nosso código para solicitar a confirmação do 
usuário para remover uma viagem. Só após esta confirmação é que a viagem será 
removida. 

Será necessário criar um novo diálogo que inclua os botões para a confirmação 
ou rejeição e passar um listener para tratar qual botão foi escolhido. Como nossa 
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atividade já implementa onClickListener utilizaremos o método já existente 
como listener do diálogo de confirmação. 

Vamos fazer o método criaDialogConfirmacao, que irá criar o novo dialog 
com as opções de confirmação e negação. 


private AlertDialog criaDialogConfirmacao() { 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(R.string.confirmacao exclusao viagem); 
builder.setPositiveButton(getString(R.string.sim), this); 
builder.setNegativeButton(getString(R.string.nao), this); 


return builder.create(); 


Repare na invocação dos métodos setPositiveButton e 
setNegativeButton que fazem os botões “Sim” e “Não”, respectivamente e 
que recebem a string que deve ser exibida para cada botão. 

O próximo passo é invocar o criaDialogConfirmacao no onCreate da 
activity e guardar uma referência para o novo AlertDialog em um atributo de 
instância: 


// Novo atributo de instância 
private AlertDialog dialogConfirmacao; 


protected void onCreate(Bundle savedInstanceState) { 
// Realiza as outras ações 


this.alertDialog = criaAlertDialog(); 
this.dialogConfirmacao = criaDialogConfirmacao() ; 


No método onClick, quando a opção “remover” for selecionada, o ::dialog: de 
confirmação será exibido e adicionamos as verificações para determinar se o botão 
pressionado foi referente ao “sim” ou ao “não”. Caso a escolha tenha sido “não”, a 
remoção não é confirmada e nada deve ser feito, exceto fechar a caixa de diálogo, o 
que pode ser realizado através do método dismiss () do próprio AlertDialog. 


@Override 
public void onClick(DialogInterface dialog, int item) { 
switch (item) { 
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case 0: 
startActivity(new Intent(this, ViagemActivity.class)); 
break; 

case 1: 
startActivity(new Intent(this, GastoActivity.class)) ; 
break; 

case 2: 
startActivity(new Intent(this, GastoListActivity.class)); 
break; 

case 3: 
dialogConfirmacao.show() ; 
break; 

case DialogInterface.BUTTON_POSITIVE: 
viagens . remove (viagemSelecionada) ; 
getListView() .invalidateViews() ; 
break; 

case DialogInterface.BUTTON_NEGATIVE: 
dialogConfirmacao.dismiss() ; 
break; 


O AlertDialog criado ficará assim: 
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Deseja realmente remover a 
viagem? 








Figura 3.18: AlertDialog com confirmação 


3.9 PROGRESSDIALOG E PROGRESSBAR 


Sempre que um operação que pode demorar for executada, como fazer download de 
informações da Internet, é importante manter o usuário informado sobre o que está 
acontecendo e que a aplicação continua funcionando. Nessas situações, podemos 
utilizar um ProgressDialog que é uma extensão do AlertDialog, e apresen- 
tar ao usuário uma animação representando o progresso da operação. Também é 
possível informar um título e uma mensagem para exibição, além de botões para 
controlar a operação, se necessário. 

O ProgressDialog pode ter uma duração indeterminada quando não há pre- 
visão de término, ou determinada quando a duração tem um valor conhecido. 

No primeiro caso, é apresentado ao usuário uma animação em formato de cir- 
culo. 

Quando o ProgressDialog tem duração determinada, uma barra de pro- 
gresso é apresentada e é possível acompanhar o andamento da tarefa através de valor 
ou porcentagem. Confira na imagem abaixo alguns exemplos de uso: 
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O Operação demorada 


Aguarde.. 


O Operação demorada 


O) Aguarde O Operação demorada 


Aguarde.. 


pa 


@ Operação demorada 


E TT 
Continuar | Pausar || Abortar 





Figura 3.19: Exemplos de ProgressDialog 


O código a seguir exemplifica como exibir um ProgressDialog com duração 
indeterminada e que pode ser cancelado pelo usuário quando o botão “Voltar” do 
aparelho for pressionado: 


boolean podeCancelar = true; 

boolean indeterminado = true; 

String titulo = "Operação demorada"; 

String mensagem = "Aguarde..."; 

ProgessDialog dialog = ProgressDialog.show(this, titulo, mensagem, 
indeterminado, podeCancelar) ; 


Quando precisamos indicar o progresso da operação para o usuário, a forma de 
criaro ProgressDialog é um pouco diferente. 

Utilizamos o construtor ProgressDialog (Context) e definimos o título e a 
mensagem através de setters. É necessário definir um estilo para a barra de progresso, 
por exemplo ProgressDialog.STYLE HORIZONTAL. Também podemos definir 





o valor máximo da barra de progresso que, ao ser alcançado, provoca o fechamento 
da caixa de diálogo. Atualização do progresso pode ser realizada através dos métodos 
setProgress (int) ou incrementProgressBy (int). 


Veja um código de exemplo que também inclui botões: 


ProgressDialog dialog = new ProgressDialog(this) ; 
dialog.setProgressStyle(ProgressDialog.STYLE HORIZONTAL); 
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dialog.setTitle(titulo) ; 

dialog.setMessage (mensagem) ; 

dialog.setCancelable(true) ; 

dialog. setMax (800) ; 

dialog.setButton(Dialog.BUTTON_NEGATIVE, 
getString(R.string.abortar), this); 

dialog.setButton(Dialog.BUTTON_NEUTRAL, 
getString(R.string.pausar), this); 

dialog.setButton(Dialog.BUTTON_POSITIVE, 
getString(R.string.continuar), this); 


dialog. show() ; 


Em algumas situações, ha a possibilidade de não termos uma operação em anda- 
mento, porém queremos indicar para o usuário o quão próximo ele está de alcançar 
determinado valor limite. Na nossa aplicação podemos, por exemplo, utilizar uma 
ProgressBar para exibir o total de gastos realizados em relação ao orçamento es- 
tipulado para a viagem. 

Incluiremos essa funcionalidade na listagem de viagens e consideraremos que 
existe um valor limite configurado para os gastos que pode ser maior ou menor do 
que o valor do orçamento. Posteriormente criaremos essa configuração e notificare- 
mos o usuário quando este valor limite for alcançado. 

A ProgressBar possui dois valores de progresso, um principal e o outro se- 
cundário. Utilizaremos o principal para exibir os valor total dos gastos realizados 
e o secundário para marcar o valor limite, se este for menor do que o orçamento. 
Inclua no layout lista viagem.xml a definição da barra de progresso abaixo do 
TextView que exibe o valor dos gastos realizados: 


<ProgressBar android:id="0+id/barraProgresso" 
android:layout width="fill parent" 
android: layout height="wrap content" 
style="?android:attr/progressBarStyleHorizontal"/> 


Depois, precisaremos alterar a ViagemListActivity para implementar 





ViewBinder pois agora temos uma ProgressBar na ListView. Para preen- 
cher os valores da barra de progresso, passaremos um array com os valores de- 
finidos para o orçamento, o limite e o valor dos gastos, para o mapa utilizado pelo 
SimpleAdapter. 

O primeiro passo, no método onCreate é adicionar um novo item nos Arrays 
dee para, que referenciarão a barra de progresso que acabamos de definir no layout. 
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@Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 


String[] de = { "imagem", "destino", "data", 


"total", "barraProgresso" }; 


int[] para = { R.id.tipoViagem, R.id.destino, 
R.id.data, R.id.valor, R.id.barraProgresso }; 


// restante da implementação 


Em seguida, no método listarViagens, que devolve as informações das vi- 
agens realizadas, vamos devolver as informações necessárias para a barra, adicio- 
nando ao Map uma nova informação: 


private List<Map<String, Object>> listarViagens() { 
viagens = new ArrayList<Map<String, Object>>(); 


Map<String, Object> item = new HashMap<String, Object>(); 
item.put("imagem", R.drawable.negocios) ; 

item.put("destino", "São Paulo"); 

item.put("data", "02/02/2012 a 04/02/2012"); 

item.put("total", "Gasto total R$ 314,98"); 
item.put("barraProgresso", new Double[]{ 500.0, 450.0, 314.98}); 
viagens.add(item) ; 


// adiciona mais informações se preferir 


return viagens; 


Por fim, temos que sobrescrever o método set ViewValue, no qual são atribuí- 
dos os valores de progresso principal e secundario além do valor maximo da barra 
de progresso, representado aqui pelo valor definido como o orçamento disponível 
para a realização da viagem. 


@Override 
public boolean setViewValue(View view, Object data, 
String textRepresentation) { 
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if (view.getId() == R.id.barraProgresso) { 
Double valores [] = (Double[]) data; 
ProgressBar progressBar = (ProgressBar) view; 
progressBar.setMax (valores [0] .intValue()); 
progressBar.setSecondaryProgress (valores[1] .intValue()); 
progressBar.setProgress (valores [2] .intValue()); 
return true; 


} 


return false; 


A nova listagem de viagens exibindo a ProgressBar ficará assim: 


a wil Ë 19h45 
São Paulo 
02/02/2012 a 04/02/2012 
Gasto total R$ 314,98 


Maceió 
14/05/2012 a 22/05/2012 
E Gasto total R$ 25834,67 
F 





Figura 3.20: Listagem de viagens com ProgressBar 
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3.10 PREFERÊNCIAS 


Muitas vezes é interessante que o usuário configure o comportamento do aplicativo 
de acordo com a sua preferência. Isso torna o aplicativo muito mais atrativo e perso- 
nalizado. Mas é claro que o esforço para desenvolver um aplicativo altamente custo- 
mizável é enorme. É necessário parcimônia e oferecer ao usuário algumas opções- 
chave. O Android oferece suporte para a gravação e armazenamento dessas prefe- 
rências bem como uma PreferenceActivity para permitir a sua edição. 

As preferências são armazenadas em pares com um elemento representando a 
chave, que servirá para a sua obtenção posterior, e o outro representando o valor 
da preferência. Podemos utilizar esse tipo de armazenamento não só para as pre- 
ferências do usuário mas também para qualquer outro tipo de dado básico que a 
aplicação possa necessitar, como por exemplo o endereço de um serviço remoto ou 
informações carregadas da Internet. 

Existe um arquivo de preferências padrão que pode ser utilizado pela aplicação, 
e quando necessário, é possível criar vários arquivos de preferências para armazenar 
informações distintas. Eles também podem ser criados por Activity. 

Na nossa aplicação, disponibilizaremos duas opções de preferência para o usuá- 
rio. Uma para que ele informe um valor percentual do orçamento das viagens, que 
quando ultrapassado pelo total de gastos realizados provocará uma notificação, e a 
outra que configura o aplicativo em um “Modo Viagem”. A proposta é que quando 
este modo estiver selecionado e o usuário for registrar um novo gasto, o aplicativo se- 
lecione automaticamente, com base na data atual, a viagem da qual o gasto se refere, 
em vez de apresentar uma listagem para que o usuário selecione a viagem correta. 

Como o Android já facilita a implementação de telas de preferências, disponibi- 
lizando elementos que já tratam da apresentação e gravação dos itens, criaremos um 
arquivo XML diferente dos arquivos de layout criados até o momento. Por questões 
de organização, manteremos o arquivo XML das preferências no diretório res/xml. 
Crie nesta pasta o arquivo preferencias.xml, com a seguinte definição: 


<?xml version="1.0" encoding="utf-8"?> 
<PreferenceScreen 
xmlns:android="http://schemas.android.com/apk/res/android" > 


<PreferenceCategory android:title="Ostring/preferencias" > 
<CheckBoxPreference 
android: key="modo_viagem" 
android: summary="@string/modo_viagem_sumario" 
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android:title="Qstring/modo viagem" /> 


<EditTextPreference 
android:dialogTitle="0string/informe valor limite" 
android:key="valor limite" 
android:defaultValue="80" 
android: summary="Ostring/valor limite sumario" 
android: title="Qstring/valor_limite"/> 
</PreferenceCategory> 


</PreferenceScreen> 


Repare que não há nenhum layout declarado ou algum widget, sendo o elemento 





raiz o <PreferenceScreen>. Os elementos que compõem a tela de preferén- 
cias são específicos. As preferências podem ser agrupadas em categorias, através do 
elemento <PreferenceCategory> para que sejam apresentadas visualmente no 
mesmo grupo. Em seguida, definimos uma preferência que faz uso de um check- 
box, através do CheckBoxPreference, para configurar o aplicativo em “Modo 
Viagem”. Já para a definição do valor limite de gastos utilizamos uma preferência 





associada a um Edit Text, cujo valor padrão é 80. 

O valor informado no atributo key será o identificador da chave onde será ar- 
mazenada a preferência e que será utilizada posteriormente para a recuperação do 
valor gravado. Para os atributos title, summary e dialogTitle definimos 
mensagens que serão apresentadas para o usuário com a descrição da preferência 
que está sendo configurada. Agora precisamos criar uma activity que estende a classe 
PreferenceActivity, e carregar o XML que define as opções. Crie uma classe 
chamada ConfiguracoesActivity com o seguinte código: 


public class ConfiguracoesActivity extends PreferenceActivity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
addPreferencesFromResource(R.xml.preferencias) ; 


No método onCreate, invocamos o addPreferencesFromResource dis- 
ponivel na PreferenceActivity para carregar o arquivo XML de preferências 
e construir a tela. Quando a opção “Configurações” da DashboardActivity for 
escolhida, a tela de preferências criada deverá ser exibida. 
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Faça as alterações necessárias no método selecionarOpcao para abrir a tela 
de preferências ( ConfiguracoesActivity) e confira como ficou a tela de prefe- 


rências: 


public void selecionarOpcao(View view) { 
switch (view.getId()) { 
//codigos existentes 
case R.id.configuracoes: 
startActivity(new Intent(this, ConfiguracoesActivity.class)) ; 
break; 


Preferéncias 


Modo Viagem 
Determina a viagem ativa co 


data 


Alerta de gastos 


Notifi 


informado 


Informe o valor limite (em %) 


Cancelar 








Figura 3.21: Telas de preferéncias do aplicativo 


Neste momento nao implementaremos as funcionalidades que irao utilizar estas 
preferéncias que acabamos de armazenar pois dependemos de itens que ainda nao 
estão prontos. No entanto, para exercitar o uso de preferências, vamos implementar 
outra funcionalidade, que é incluir na nossa aplicação uma opção para o usuário 
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manter-se logado no aplicativo. Isso utilizará a classe SharedPreferences para 
acessar e gravar dados em um arquivo de preferência de uma Activity. 

Na tela de login, incluiremos um checkbox para indicar a opção do usuário e 
gravaremos essa informação no arquivo de preferências da atividade. 


<CheckBox 
android: id="0+id/manterConectado" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android: text="@string/manter_conectado" /> 


Quando o aplicativo for iniciado, a preferência sera consultada para determinar 
se a tela de login deve ser apresentada ou se dashboard deve ser exibida. Altere o 
login.xml para incluir uma checkbox da seguinte forma e verifique como ficou o 
código da BoaViagemActivity: 

Precisamos obter uma instância de SharedPreferences no modo pri- 
vado, o que permite alterações no arquivo de preferência apenas pela aplicação 
que a criou, e em seguida tentar recuperar algum valor gravado para a chave 
manter conectado. Caso nenhum valor seja encontrado, o valor false deve 
ser retornado. Caso o valor recuperado seja true, em vez de apresentar a tela de 
login,a DashboardActivity é iniciada. 


public class BoaViagemActivity extends Activity { 
private static final String MANTER_CONECTADO = "manter_conectado"; 
private EditText usuario; 
private EditText senha; 
private CheckBox manterConectado; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.login); 


usuario = (EditText) findViewById(R.id.usuario); 
senha = (EditText) findViewById(R.id.senha) ; 
manterConectado = (CheckBox) findViewById(R.id.manterConectado) ; 


SharedPreferences preferencias = getPreferences (MODE PRIVATE); 


boolean conectado = 
preferencias.getBoolean (MANTER CONECTADO, false); 
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if (conectado) { 
startActivity (new Intent(this, DashboardActivity.class)); 


No método entrarOnClick tratamos da escolha do usuário em se manter ou 
não conectado. 


Após a autenticação bem sucedida, podemos recuperar um Editor para fazer as 





alterações desejadas no arquivo de preferências e o utilizamos para incluir na chave 
manter conectado o valor booleano obtido da checkbox. Para efetivar as altera- 
ções é necessário invocar o método editor.commit (). Em seguida, iniciamos a 
dashboard. Execute a aplicação e experimente esta nova funcionalidade! 


public void entrarOnClick(View v) { 
String usuarioInformado = usuario.getText().toString(); 
String senhaInformada = senha.getText().toString() ; 


if ("leitor".equals(usuarioInformado) && 
"123" .equals (senhaInformada)) { 


SharedPreferences preferencias = 
getPreferences (MODE PRIVATE); 


Editor editor = preferencias.edit(); 
editor.putBoolean (MANTER CONECTADO, 

manterConectado. isChecked()); 
editor.commit(); 


startActivity (new Intent (this,DashboardActivity.class)); 


+ 
elsef{ 
String mensagemErro = getString(R.string.erro_autenticacao) ; 
Toast toast = Toast.makeText(this, mensagemErro, 
Toast. LENGTH_SHORT) ; 
toast.show() ; 
} 
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Para definir outros arquivos de preferências ou ter um arquivo de preferência que 
será acessado por mais atividades a partir de um determinado nome, basta recuperar 
uma SharedPreferences desta forma: 


String NOME PREFERENCIAS = "PREFERENCIAS_BOAVIAGEM" ; 
SharedPreferences preferencias = 
getSharedPreferences (NOME PREFERENCIAS, 0); 


Quando utilizamos as facilidades da PreferenceActivity, o arquivo de pre- 





ferências criado por ela deve ser acessado através do PreferenceManager, infor- 
mando o contexto (a atividade que irá utilizar o arquivo) da seguinte forma: 


SharedPreferences preferencias = PreferenceManager 
. getDefaultSharedPreferences (contexto); 


3.11 CONCLUSÃO 


Chegamos ao final de mais um capítulo! Aqui aprendemos na prática como utilizar 
os principais layouts disponíveis na plataforma Android, bem como fazer uso dos 
widgets fundamentais para a entrada de dados. Também criamos ListViews per- 
sonalizadas para exibir listagens e acrescentamos funcionalidades como menus de 
opção e de contexto. Empregamos AlertDialogs para a aplicação se comunicar 
com o usuário, além de salvar as suas preferências. A primeira versão da nossa apli- 
cação BoaViagem está quase pronta! Vamos prosseguir para o capítulo seguinte e 
descobrir como persistir e recuperar os dados utilizando o SQLite. 
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CAPÍTULO 4 


Persistência de dados no Android 
com SQLite 


Para o nosso aplicativo BoaViagem as interações com o usuário já estão praticamente 
prontas, no entanto, ainda não estamos persistindo os dados das viagens e dos gastos 
realizados. O objetivo deste capítulo é armazenar e recuperar dados da nossa apli- 
cação utilizando o SQLite, disponível na plataforma Android, que, ao contrário da 
maioria dos bancos de dados SQL, não necessita de um processo servidor. 

O SQLite armazena as tabelas, views, índices e triggers em apenas um arquivo em 
disco, no qual são realizadas as operações de leitura e escrita. No Android, o banco 
de dados é acessível por qualquer classe da aplicação que o criou, mas não pode ser 
acessado por outra. 

Quando a aplicação que contém o banco de dados é desinstalada, os dados ar- 
mazenados também são removidos. 


4.1. O processo de criação do banco de dados Casa do Código 





4.1 O PROCESSO DE CRIAÇÃO DO BANCO DE DADOS 


Para utilizar o SQLite em nossa aplicação, precisamos usar uma API que já possua 
todo o trabalho de se comunicar com o banco de dados encapsulado dentro dela. É 
justamente esse o papel da classe SQLiteOpenHelper, que devemos herdar. 

Esta classe facilita a criação, versionamento e acesso ao banco de dados. Então 
vamos começar! Crie uma nova classe com o nome de Dat abaseHelper herdando 
de SQLiteOpenHelper 


public class DatabaseHelper extends SQLite0penHelpert 


Ao herdar desta classe, devemos implementar os métodos onCreate e 
onUpgrade para criar as tabelas e incluir os dados iniciais, caso necessário. Além 
disso, é preciso tratar das regras de atualização de dados e de estrutura do banco 
quando necessário. 

Também precisaremos chamar o construtor do SQLiteOpenHelper in- 
formando o contexto, o nome do banco de dados e sua versão atual e um 


CursorFactory se necessário: 


public class DatabaseHelper extends SQLite0penHelpert 


private static final String BANCO DADOS = "BoaViagem"; 
private static int VERSAO = 1; 


public DatabaseHelper (Context context) { 

super (context, BANCO DADOS, null, VERSAO); 
@Override 
public void onCreate(SQLiteDatabase db) {} 
@Override 


public void onUpgrade(SQLiteDatabase db, int oldVersion, 
int newVersion) {} 


Teremos duas tabelas no banco de dados, uma para armazenar os dados das via- 
gens e outra para os gastos realizados. A criação das tabelas deve ser feita no método 
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onCreate, que é invocado quando tentamos acessar o banco de dados pela primeira 
vez e o mesmo ainda não está criado. 

Para criar as tabelas, executamos uma instrução SQL usando o método 
execSQL, da classe SQLiteDatabase, que não possui retorno. Dessa forma, po- 
demos utilizá-lo somente para instruções cujo resultado não precisa ser avaliado. Já 
o método onUpgrade, deve implementar as regras para atualização da estrutura do 
banco e também dos dados quando uma nova versão for disponibilizada. 


OOverride 
public void onCreate(SQLiteDatabase db) { 
db.execSQL("CREATE TABLE viagem ( id INTEGER PRIMARY KEY," + 
" destino TEXT, tipo viagem INTEGER, data chegada DATE," + 
" data saida DATE, orcamento DOUBLE," + 
" quantidade pessoas INTEGER) ;"); 


db.execSQL("CREATE TABLE gasto ( id INTEGER PRIMARY KEY," + 
" categoria TEXT, data DATE, valor DOUBLE," + 
" descricao TEXT, local TEXT, viagem id INTEGER," + 
" FOREIGN KEY (viagem id) REFERENCES viagem(_id));"); 


Quando uma nova versão do aplicativo e do banco de dados for lançada, o An- 
droid verificará qual versão do banco de dados o usuário possui, e se esta for me- 
nor do que a atual, então o método onUpgrade será invocado. Como por en- 
quanto ainda estamos na primeira versão, não implementaremos nada no método 
onUpgrade. 

Caso seja necessário, por exemplo, em uma nova versão do aplicativo, acres- 
centar uma nova coluna na tabela gasto para armazenar o nome da pessoa que o 


realizou, poderíamos implementar o método onUpgrade dessa forma: 


OOverride 
public void onUpgrade(SQLiteDatabase db, 
int oldVersion, int newVersion) { 


db.execSQL("ALTER TABLE gasto ADD COLUMN pessoa TEXT"); 


Tanto a criação do banco quanto a sua atualização só acontecem de fato 
quando obtemos uma instância de SQLiteDatabase e não quando instanciamos 
o DatabaseHelper. Veremos esses detalhes mais adiante. 
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CONVENÇÃO PARA A COLUNA ID 


Um detalhe importante é que as colunas que são chaves primárias 
possuem o nome de _id. Esta é uma convenção utilizada no Android 
para que os resultados de consultas realizadas nessas tabelas possam ser 
utilizadas em CursorAdapters, que dependem de uma coluna com 
este nome. 











4.2 GRAVAÇÃO DAS VIAGENS NO BANCO DE DADOS 


Com o banco de dados já preparado, vamos começar a armazenar os dados das 
viagens. Neste momento, iremos focar em como realizar as operações no banco 
de dados. No método onCreate, da ViagemActivity, instanciaremos o 
DatabaseHelper e também criaremos referências para todas as views que con- 
tém os dados informados pelo usuário, pois teremos que os gravar. O código ficará 
assim: 


// novos atributos 

private DatabaseHelper helper; 

private EditText destino, quantidadePessoas, orcamento; 
private RadioGroup radioGroup; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.viagem); 


Calendar calendar = Calendar .getInstance(); 
calendar .get (Calendar. YEAR); 
mes = calendar .get (Calendar. MONTH); 
dia = calendar.get (Calendar.DAY OF MONTH) ; 


ano 


dataChegadaButton = (Button) findViewById(R.id.dataChegada) ; 
dataSaidaButton = (Button) findViewById(R.id.dataSaida) ; 


// recuperando novas views 


destino = (EditText) findViewById(R.id.destino) ; 
quantidadePessoas = (EditText) findViewById(R.id.quantidadePessoas) ; 
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orcamento = (EditText) findViewById(R.id.orcamento) ; 
radioGroup = (RadioGroup) findViewById(R.id.tipoViagem); 


// prepara acesso ao banco de dados 
helper = new DatabaseHelper (this); 


Agora precisaremos implementar de fato a inserção dos dados informados 
pelo usuário. Isto será feito no método salvarViagem, que é disparado 
quando o usuário pressiona o botão “Salvar”. Para realizar operações de escrita 
no banco de dados, devemos recuperar um SQLiteDatabase através método 
getWritableDatabase (), definido na classe SQLiteOpenHelper e disponível 
por meio de herança na nossa classe DatabaseHelper. 


public void salvarViagem(View view) { 
SQLiteDatabase db = helper.getWritableDatabase() ; 


Para inserir os dados, podemos montar manualmente uma instrução SQL de 
insert ou utilizar o ContentValues informando um conjunto de dados no for- 
mato chave-valor, no qual a chave é a coluna do banco de dados e o valor é o dado a 
ser armazenado. 

Por simplificação, não realizaremos nenhuma validação dos dados, simples- 
mente recuperaremos os dados informados pelo usuário através das views e co- 


locaremos em um ContentValues: 


public void salvarViagem(View view) 1 
SQLiteDatabase db = helper.getWritableDatabase(); 


ContentValues values = new ContentValues(); 
values.put("destino", destino.getText () .toString()); 
values.put("data chegada", dataChegada. getTime()); 
values.put("data saida", dataSaida.getTime()); 
values.put("orcamento", orcamento.getText ().toString()); 
values. put ("quantidade pessoas", 
quantidadePessoas.getText().toString()); 


int tipo = radioGroup.getCheckedRadioButtonId(); 


if(tipo == R.id.lazer) { 
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values.put("tipo viagem", Constantes.VIAGEM LAZER); 
} else { 
values. put ("tipo_viagem", Constantes.VIAGEM_NEGOCIOS) ; 


Agora que temos o ContentValues preparado, podemos invocar o método 
insert do SQLiteDatabase, que receberá 3 parâmetros. O primeiro informando 
a tabela, e o terceiro receberá o ContentValues. O segundo parâmetro, em que 
informaremos nu11, representa o nome das chaves do ContentValues que devem 
ter seu valor inserido como null. No nosso caso, não desejamos que nenhuma 
coluna tenha seu valor anulado, por isso não passamos nada. 

Por fim, caso o registro seja inserido com sucesso, o método insert retorna 
o identificador do novo registro e em caso de falha retorna -1 e mostramos uma 
mensagem na tela de acordo com esse resultado. 


public void salvarViagem(View view) 1 
// prepara o ContentValues 


long resultado = db.insert("viagem", null, values); 


if (resultado != -1 ){ 
Toast .makeText (this, getString(R.string.registro salvo), 
Toast .LENGTH SHORT) .show() ; 
}else{ 
Toast .makeText (this, getString(R.string.erro_salvar), 
Toast .LENGTH_SHORT) .show() ; 











A coluna tipo viagemédotipo INTEGER para evitar o uso direto de núme- 





ros no código, podemos criar constantes para representar os seus possíveis valores. 
Como isto é recorrente, criamos uma classe chamada Constantes que vai centra- 
lizar todas as constantes utilizadas na aplicação. 

Inicialmente esta classe terá apenas os tipos de viagem, mas no futuro adiciona- 


remos novas informações. O código dela é o seguinte 


public class Constantes { 
public static final int VIAGEM LAZER = 1; 
public static final int VIAGEM_NEGOCIOS = 2; 
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O leitor mais atento deve ter percebido que, ao incluir os valores no 
ContentValues para serem inseridos no banco de dados, o tipo do dado não é 
o mesmo daquele determinado na criação da tabela correspondente. Por exemplo, 
a coluna data chegada é do tipo %DATE%, porém atribuimos a ela um valor do 
tipo long 

Não há problema! O SQLite trabalha com tipos dinâmicos e sabe converter os da- 





dos adequadamente para o formato desejado. Vale ressaltar que para os tipos DATE 
é interessante armazená-los informando o seu valor como long para que possamos 
posteriormente construir mais facilmente um objeto do tipo java.util.Date. 

Um detalhe importante é a necessidade de fechar o banco de dados quando 
seu uso não for mais necessário. Podemos fazer isso chamando o método 
helper.close (). Nem sempre é fácil determinar o melhor momento para fechar 
o banco de dados, por isso é comum o fazer quando a activity for finalizada e des- 
truída, sobrescrevendo o método onDest roy. Lembre-se de fazer isso sempre que 
utilizar um banco de dados. 


@Override 

protected void onDestroy() { 
helper.close(); 
super.onDestroy() ; 


Com essas alterações, finalizamos a inserção das informações de viagens! Os 
dados da viagem agora já são armazenados no banco de dados. Fácil não é mesmo? 


Agora precisamos saber quais dados temos gravados. 


4.3 LISTANDO AS VIAGENS DIRETO DO SQLITE 


Uma vez que as informações das viagens já estão armazenados no banco de da- 
dos, precisaremos recuperá-las para a exibição na lista de viagens, que no momento 
conta apenas com uma implementação temporária e dados estáticos. Na classe 





ViagemListActivity vamos reaproveitar os códigos que tratam da ListView 
e alterar a implementação do método listarViagens () para buscar as informa- 
ções das viagens no banco de dados. 

Para iniciar esta implementação, devemos instanciar um DatabaseHelper e 
também recuperar o valor limite de gastos das preferências do usuário. Podemos 
aproveitar e criar um SimpleDateFormat para formatar as datas recuperadas do 
banco de dados, tudo isso no método onCreate: 


135 


4.3. Listando as viagens direto do SQLite Casa do Código 





private DatabaseHelper helper; 
private SimpleDateFormat dateFormat; 
private Double valorLimite; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super .onCreate (savedInstanceState); 


helper = new DatabaseHelper (this); 
dateFormat = new SimpleDateFormat ("dd/MM/yyyy'D; 


SharedPreferences preferencias = 
PreferenceManager.getDefaultSharedPreferences(this); 


String valor = preferencias.getString("valor limite", "-1"); 


valorLimite = Double.valueOf (valor); 


//códigos existentes 


No método listarViagens () faremos uma consulta no banco de dados para 
obter todas as viagens cadastradas. Ao contrário do que foi feito para salvar um 
registro, que é uma operação de escrita, agora utilizaremos uma instância de leitura 
do SQLiteDatabase, através do método getReadableDatabase. A partir dela, 
faremos uma consulta e obteremos um Cursor para navegar pelos resultados: 


1 private List<Map<String, Object>> listarViagens() { 


2 


3 SQLiteDatabase db = helper.getReadableDatabase() ; 

4 Cursor cursor = 

5 db.rawQuery("SELECT _id, tipo_viagem, destino, " + 

6 "data_chegada, data_saida, orcamento FROM viagem", 
7 null); 

8 //códigos existentes 

9 + 


Nesta implementação, utilizamos o método rawQuery que executa um SQL 
diretamente. O Cursor retornado está sempre posicionado antes do primeiro re- 
sultado. Para iniciarmos a iteração sobre os dados, precisamos apontá-lo para o pri- 
meiro registro e também saber a quantidade de linhas retornadas. Além disso, tam- 
bém utilizaremos um método para avançar para o próximo registro e para fechar o 
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cursor quando finalizarmos a iteração. Os métodos disponíveis para isso são os 
seguintes: 


// move o cursor para o primeiro registro 
cursor .moveToFirst(); 

// retorna a quantidade de linhas 
cursor.getCount () ; 

// avança para o próximo registro 

cursor .moveToNext (); 

// fecha o cursor 

cursor.close(); 


Para obter os dados do Cursor, devemos invocar um getter com o tipo do dado, 
informando o índice da coluna desejada. Por exemplo, para recuperar o valor da 


c 





coluna “ 








“id”, que é do tipo INTEGER, chamamos o método cursor.getInt (0), 





onde 0 é o índice da coluna. Os outros getters disponíveis são: 


cursor.getInt (columnIndex) ; 
cursor .getFloat (columnIndex) ; 
cursor .getLong(columnIndex) ; 
cursor. getShort (columnIndex) ; 
cursor. getString(columnIndex) ; 
cursor .getBlob(columnIndex) ; 


Quando não sabemos ao certo o indice da coluna, mas sabemos o seu nome, 
podemos utilizar o método getColumnIndex (columnName) para recuperar sua 
posição. 

Agora que realizamos a consulta e recuperamos o Cursor, precisamos 
posicioná-lo no primeiro registro, através do método moveToFirst: 


SQLiteDatabase db = helper.getReadableDatabase(); 
Cursor cursor = 
db.rawQuery("SELECT _id, tipo viagem, destino, " + 
"data_chegada, data_saida, orcamento FROM viagem", 
null); 


cursor .moveToFirst (); 


O próximo passo é guardar em um mapa os dados de cada registro. Nesse mapa, 
a chave conterá o nome da informação e o valor será a informação que foi recupe- 
rada do banco de dados. Teremos que fazer isso para o id, tipo de viagem, 
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destino, data de chegada, data de saídae orcamento, fazendo conver- 
sões onde necessário, como por exemplo, de long para Date. Todos os registros 
serão guardados em um ArrayList, contendo as viagens: 


private List<Map<String, Object>> listarViagens() { 
SQLiteDatabase db = helper.getReadableDatabase() ; 
Cursor cursor = 
db.rawQuery("SELECT _id, tipo_viagem, destino, " + 
"data_chegada, data_saida, orcamento FROM viagem", 
null); 


cursor.moveToFirst(); 


viagens = new ArrayList<Map<String, Object>>(); 
for (int i = 0; i < cursor.getCount(); i++) { 
Map<String, Object> item = new HashMap<String, Object>(); 


String id = cursor.getString(0) ; 

int tipoViagem = cursor.getInt(1); 
String destino = cursor.getString(2) ; 
long dataChegada = cursor.getLong(3) ; 
long dataSaida = cursor.getLong(A4) ; 
double orcamento = cursor.getDouble(5) ; 


item.put("id", id); 
if (tipoViagem == Constantes.VIAGEM_LAZER) { 
item.put("imagem", R.drawable.lazer) ; 


} else { 
item.put("imagem", R.drawable.negocios) ; 


item.put("destino", destino); 


Date dataChegadaDate = new Date (dataChegada) ; 
Date dataSaidaDate = new Date(dataSaida) ; 


String periodo = dateFormat.format(dataChegadaDate) + "a 
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} 


+ dateFormat .format (dataSaidaDate) ; 

item.put("data", periodo); 
double totalGasto = calcularTotalGasto(db, id); 
item.put("total", "Gasto total R$ " + totalGasto); 
double alerta = orcamento * valorLimite / 100; 
Double [] valores = 

new Double[] { orcamento, alerta, totalGasto }; 
item. put ("barraProgresso", valores); 


viagens.add(item) ; 


cursor.moveToNext () ; 


cursor.close(); 


return viagens; 


Para cada viagem da lista, também deve ser apresentado o valor total gasto na- 


quela viagem. Faremos esta implementação no método calcularTotalGasto, 


que realizará uma consulta que soma o valor dos gastos realizados com o id infor- 


mado como parâmetro. O código desse método ficará da seguinte maneira: 


private double calcularTotalGasto(SQLiteDatabase db, String id) { 
Cursor cursor = db.rawQuery( 


"SELECT SUM(valor) FROM gasto WHERE viagem id = ?", 
new String[]{ id }); 


cursor .moveToFirst(); 
double total = cursor.getDouble(0); 
cursor.close(); 


return total; 


O segundo parâmetro do método rawQuery espera um Array de String,e 








serve para informar os valores que serão utilizados na cláusula WHERE da consulta. 





Neste caso, queremos restringir a soma dos valores gastos apenas para a viagem cujo 


id for igual ao informado. 
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Pronto! Agora temos nossa lista de viagens totalmente dinâmica, obtendo as 
informações diretamente do banco de dados. 


Existem ainda duas outras formas de realizar consultas em um banco SQ- 
Lite no Android. Uma delas é através dos métodos query disponíveis na classe 
SQLDatabase. Com ela, devemos informar cada trecho da nossa consulta através 
de um parâmetro, ou seja, precisa-se informar os campos devolvidos no select, 
O groupBy, 0 having e assim por diante. Veja a nossa primeira consulta reescrita 
utilizando essa forma: 


String tabela = "viagem"; 

String[] colunas = new String[]{"_id", "tipo viagem", "destino", 
"data chegada", "data saida", 
"orcamento"}; 

String selecao = null; 

String[] selecaoArgs = null; 

String groupBy = null; 

String having = null; 

String orderBy = null; 

Cursor cursor = db.query(tabela, colunas, selecao, selecaoArgs, 

groupBy, having, orderBy) ; 


A outra maneira de realizar consultas é utilizando um SQLiteQueryBuilder. 
Através dessa classe é possível construir programaticamente consultas complexas, 
incluindo várias tabelas. A seguir veja a nossa consulta construída utilizando esta 
abordagem: 


SQLiteQueryBuilder builder = new SQLiteQueryBuilder(); 
builder.setTables("viagem") ; 
Cursor cursor = builder.query(db, colunas, selecao, 


selecaoArgs, groupBy, 
having, orderBy) ; 


4.4 ATUALIZAÇÃO DE VIAGENS E O UPDATE NO SQLITE 


A próxima implementação que faremos em nosso aplicativo é a atualização das in- 
formações de uma determinada viagem. Quando a lista de viagens é apresentada e 
o usuário seleciona alguma delas, um AlertDialog com opções é exibido, sendo 
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que uma delas diz respeito à edição da viagem selecionada. Implementaremos esta 
funcionalidade agora. 

A ideia é que quando o usuário selecionar a opção “editar”, o id da viagem se- 
lecionada seja recuperado do mapa e colocado como um extra na intent que irá 
abrira ViagemActivity. Depois, no onCreate da ViagemActivity recupe- 
raremos esse valor para saber se estamos criando uma nova viagem ou editando uma 
existente. 

No método salvarViagem, verificaremos este id para executar uma ope- 
ração de insert ou de update. Veja o código do método onClick da classe 
ViagemListActivity para tratar a edição: 





@Override 
public void onClick(DialogInterface dialog, int item) { 
Intent intent; 
String id = (String) viagens.get (viagemSelecionada) .get("id") ; 


switch (item) { 

case 0: // editar viagem 
intent = new Intent(this, ViagemActivity.class) ; 
intent.putExtra(Constantes.VIAGEM_ID, id); 
startActivity (intent) ; 
break; 


// codigos existentes 


Primeiro recuperamos o id da viagem que o usuário deseja editar e o colocamos 
como informação extra na intent que abrirá a ViagemActivity. Agora no 
método onCreate da ViagemActivity, obtemos este valor e, caso seja válido, 
carregaremos as informações da viagem com o id informado a partir do banco de 
dados para exibir ao usuário. As alterações de código são as seguintes: 


// demais atributos 
private String id; 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
//códigos existentes 
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id = getIntent ().getStringExtra(Constantes.VIAGEM ID); 


if(id != null){ 
prepararEdicao() ; 





No método prepararEdicao buscaremos a viagem com o id informado e 
atribuiremos os valores obtidos aos widgets da tela. 


private void prepararEdicao() { 
SQLiteDatabase db = helper.getReadableDatabase() ; 


Cursor cursor = 
db.rawQuery ("SELECT tipo viagem, destino, data chegada, " + 
"data saida, quantidade pessoas, orcamento " + 
"FROM viagem WHERE _id = ?", new String[]{ id }); 


cursor .moveToFirst (); 
SimpleDateFormat dateFormat = new SimpleDateFormat ("dd/MM/yyyy") ; 


if (cursor.getInt (0) == Constantes.VIAGEM LAZER) 
radioGroup.check(R.id.lazer) ; 

} else { 
radioGroup.check(R.id.negocios); 


destino .setText (cursor .getString(1)); 

dataChegada = new Date (cursor .getLong(2)); 

dataSaida = new Date(cursor.getLong(3)); 
dataChegadaButton.setText(dateFormat .format (dataChegada) ) ; 
dataSaidaButton. setText (dateFormat. format (dataSaida)); 
quantidadePessoas.setText (cursor .getString(4)); 
orcamento.setText (cursor .getString(5)); 

cursor.close(); 


O último passo é alterar o método salvarViagem para decidir se vamos reali- 
zar uma operação de insert ou de update com base no atributo id recuperado 
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da intent. Seo idforiguala null, então nada foi informado na intent e trata- 
se de um novo registro de viagem. Caso contrário, utilizaremos o método update 
quem tem uma assinatura similar à do método insert, recebendo dois parâmetros 
a mais para indicar os critérios de restrição. Informaremos nestes parâmetros que 
a atualização deve ser realizada para o registro com _id igual ao informado. As 
alterações no código do salvarViagem ficarão assim: 


public void salvarViagem(View view) 1 
// códigos existentes 


if(id == null)( 


resultado = db.insert("viagem", null, values) ; 
} else { 
resultado = db.update("viagem", values, "_id = ?", 


new String[]{ id }); 


// códigos existentes 


A operação de update retorna a quantidade de registros afetados pelo comando 
e podemos utilizar esta informação para saber se a atualização deu certo. E é isso, 
mais uma funcionalidade pronta! Já podemos testar a atualização de uma viagem 
existente. Agora só nos resta poder excluir as informações que não queremos mais. 


4.5 COMO APAGAR UMA VIAGEM COM O SQLITE E O AN- 
DROID 


O que precisamos agora é implementar a exclusão de uma viagem e de seus respec- 





tivos gastos quando a opção “Remover” for escolhida na ViagemListActivity 
e também a partir da mesma opção existente no menu da ViagemActivity. As- 
sim como nas operações de insert e update, para a exclusão de registro temos o 
método delete disponívelno SQLiteDatabase. 


No onClick da ViagemListActivity iremos incluir a chamada para um 





método que executará a exclusão dos registros. O método de exclusão só poderá ser 
chamado se o usuário confirmar a operação. Vamos alterar o código para que chame 


o método adequado: 
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@Override 
public void onClick(DialogInterface dialog, int item) { 
// codigos existentes 


switch (item) { 


case DialogInterface.BUTTON_POSITIVE: // exclusão 
viagens . remove (viagemSelecionada) ; 
removerViagem(id) ; 
getListView() .invalidateViews() ; 
break; 


O id da viagem a ser excluída será passada como parâmetro para o método 
removerViagem, no qual primeiramente excluímos todos os gastos associados e 


depois removemos a viagem propriamente dita. 


private void removerViagem(String id) 1 
SQLiteDatabase db = helper.getWritableDatabase() ; 
String where [] = new String[]{ id }; 
db.delete("gasto", "viagem_id = ?", where); 
db.delete("viagem", " id = ?", where); 


Pronto, agora já conseguimos realizar as principais operações de banco de dados 
com o SQLite e o Android! 


4.6 DICAS E BOAS PRÁTICAS AO TRABALHAR COM BANCO 
DE DADOS NO ANDROID 


Para ser mais didático e também focar nas operações com o banco de dados, não 
tivemos nenhuma preocupação em escrever um código bom e fácil de manter. No 
entanto, uma vez que já aprendemos a utilizar o SQLite e compreender como ele 
funciona chegou o momento de aprimorar o código da nossa aplicação. 

Basicamente existem três problemas nos códigos que escrevemos. O primeiro 
deles é que não estamos utilizando nenhuma classe para representar o domínio da 
nossa aplicação. Poderíamos criar as classes Viagem e Gasto para representar 
esses objetos, obtendo assim um código mais organizado e de fácil manipulação, 
sem contar é claro com os demais benefícios do design orientado a objetos. 
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Como parte do processo de refatoraçãoo podemos criar es- 
tas duas novas classes, Viagem, em um novo pacote chamado 


br.com.casadocodigo.boaviagem. domain 


public class Viagem { 
private Long id; 
private String destino; 
private Integer tipoViagem; 
private Date dataChegada; 
private Date dataSaida; 
private Double orcamento; 
private Integer quantidadePessoas; 


public Viagem() {} 


public Viagem(Long id, String destino, Integer tipoViagem, 

Date dataChegada, Date dataSaida, Double orcamento, 
Integer quantidadePessoas) { 

this.id = id; 

this.destino = destino; 

this.tipoViagem = tipoViagem; 

this.dataChegada = dataChegada; 

this.dataSaida = dataSaida; 

this.orcamento = orcamento; 

this.quantidadePessoas = quantidadePessoas; 


// getters e setters 


E também a classe Gasto: 


public class Gasto { 


private Long id; 

private Date data; 
private String categoria; 
private String descricao; 
private Double valor; 
private String local; 
private Integer viagemId; 
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public Gasto() {} 


public Gasto(Long id, Date data, String categoria, String descricao, 
Double valor, String local, Integer viagemId) { 
this.id = id; 
this.data = data; 
this.categoria = categoria; 
this.descricao = descricao; 
this.valor = valor; 
this.local = local; 
this.viagemId = viagemid; 


//getters e setters 


Outro problema é que estamos diretamente manipulando diversas St ring, que 
representam as tabelas e suas respectivas colunas. Se alguma delas mudar, teremos 
que varrer o codigo e alterar cada ocorréncia dessa String. 

Além disso, os códigos que se referem ao acesso aos dados estão misturados com 
códigos da Activity que deveriam essencialmente tratar apenas da interação com 
o usuário. Novamente, qualquer alteração na estrutura do banco de dados influenci- 
aria todo o restante do código da aplicação. Precisamos separar as responsabilidades. 

Resolveremos esses problemas utilizando um objeto de acesso a dados, o DAO - 
Data Access Object, que é um padrão para implementar a separação da lógica de ne- 
gócio das regras de acesso a banco de dados. Podemos criar a classe BoaViagemDAO 
no pacote br.com. casadocodigo .boaviagem. dao que inicialmente terá o se- 
guinte código: 


public class BoaViagemDAO { 


private DatabaseHelper helper; 
private SQLiteDatabase db; 


public BoaViagemDAO (Context context) { 
helper = new DatabaseHelper (context) ; 


private SQLiteDatabase getDb() { 
if (db == null) { 
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db = helper. getWritableDatabase() ; 
} 


return db; 


public void close(){ 
helper.close(); 


O BoaViagemDAO define um construtor que recebe o contexto da aplicação e 
instancia um DatabaseHelper. Também definimos um método que retorna uma 
instância de SQLiteDatabase, criando-a se necessário. Utilizaremos sempre este 
método para obter uma instância de SQLiteDatabase e, a partir dela, executar as 
operações com o banco de dados. 

Você pode estar se perguntando por que fizemos isso em vez de inicializar 
logo a variável db no construtor. O motivo é que o Android executa as ope- 
rações de criação e atualização do banco apenas quando solicitamos uma ins- 
tância de SQLiteDatabase, através dos métodos getWritableDatabase ou 
getReadableDatabase. 

Como essas operações podem ser demoradas, recomenda-se não invocar esses 
métodos em construtores e métodos de inicialização, como no onCreate de uma 
Activity. Portanto, devemos postergar a invocação desses métodos até que re- 
almente seja necessário executar uma operação com o banco de dados. No nosso 
DAO, também disponibilizamos o método close que invoca o método de mesmo 
nome do DatabaseHelper para fechar o banco de dados aberto. 

Antes de implementar os métodos de acesso a dados que são pertinentes para 
a nossa aplicação, vamos incluir algumas constantes para representar as tabelas e 
colunas existentes no banco de dados. Como as instruções de criação do banco ficam 
na classe DatabaseHelper, podemos definir essas constantes lá. Veja como ficou: 


public class DatabaseHelper extends SQLiteOpenHelper{ 
//constantes ja existentes 
public static class Viagem { 
public static final String TABELA = "viagem"; 


public static final String _ID = "_id"; 
public static final String DESTINO = "destino"; 
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public static final String DATA CHEGADA = "data chegada"; 

public static final String DATA SAIDA = "data saida"; 

public static final String ORCAMENTO = "orcamento"; 

public static final String QUANTIDADE_PESSOAS = 
"quantidade_pessoas"; 

public static final String TIPO_VIAGEM = "tipo_viagem"; 


public static final String[] COLUNAS = new String[]{ 
_ID, DESTINO, DATA_CHEGADA, DATA_SAIDA, 
TIPO_VIAGEM, ORCAMENTO, QUANTIDADE_PESSOAS }; 


public static class Gastof 
public static final String TABELA = "gasto"; 
public static final String _ID = "_id"; 
public static final String VIAGEM ID = "viagem id"; 
public static final String CATEGORIA = "categoria"; 
public static final String DATA = "data"; 
public static final String DESCRICAO = "descricao"; 
public static final String VALOR = "valor"; 
public static final String LOCAL = "local"; 


public static final String[] COLUNAS = new String[]{ 
_ID, VIAGEM_ID, CATEGORIA, DATA, DESCRICAO, VALOR, LOCAL 
+; 
} 


// demais códigos existentes 


O BoaViagemDAO terá métodos que fazem exatamente o que já implementamos 
diretamente na Activity, com a diferença de que, em vez de retornar objetos do 
tipo Cursor, irá retornar listas de objetos de domínio e também receberá objetos 
do tipo Viageme Gasto para serem inseridos. Além disso, todas as referências a 
tabelas e colunas serão feitas utilizando as constantes definidas anteriormente. Um 
exemplo de método que terá no DAO éo listarViagens: 


public List<Viagem> listarViagens(){ 

Cursor cursor = getDb() .query (DatabaseHelper.Viagem. TABELA, 
DatabaseHelper.Viagem.COLUNAS, 
null, null, null, null, null); 

List<Viagem> viagens = new ArrayList<Viagem>() ; 
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while(cursor.moveToNext ()){ 
Viagem viagem = criarViagem(cursor) ; 
viagens.add(viagem) ; 

+ 

cursor.close(); 

return viagens; 


Você pode consultar o código completo desse DAO no repositório do projeto do 
livro, em https://github.com/joaobmonteiro/livro-android. 


4.7 CONCLUSAO 


Neste capítulo, apresentamos os passos necessários para criar um banco de dados 
SQLite no Android e também aprendemos como realizar as principais operações 





como insert, update, delete e query. 

Também vimos como executar instruções SQL arbitrárias com o execSQL e 
também consultas com o rawQuery. Além disso, utilizamos o padrão DAO para 
organizar melhor nosso código e fizemos algumas refatorações para melhorá-lo. 

As funcionalidades implementadas são para a persistência das informações de 
viagens. Agora fica como dever de casa implementar as mesmas funcionalidades 
para os gastos, já utilizando o DAO apresentado. Caso tenha dúvidas ou queira com- 
parar sua implementação, consulte o código-fonte da aplicação disponibilizado em 
http://github.com/joaobmonteiro/livro-android. 
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Compartilhe dados entre aplicações 
com os Content Providers 


Os provedores de conteúdo (content providers) são componentes da plataforma An- 
droid utilizados para o compartilhamento de dados entre aplicações, que podem 
estar armazenados em um banco de dados SQLite local, em arquivos armazenados 
no próprio dispositivo ou mesmo na web. 

O content provider se responsabiliza por oferecer uma forma simples e segura 
para acessar e modificar esses dados, independentemente de onde estejam armaze- 
nados. 

Geralmente, os provedores de conteúdo disponibilizam algum tipo de interface 
gráfica para manipular os dados, como é o caso do provider de contatos do telefone. 

Neste capítulo veremos como utilizar os provedores de conteúdo e também cria- 
remos um content provider para compartilhar nossas informações de viagens, arma- 
zenadas no aplicativo BoaViagem. 
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5.1 COMO FUNCIONA UM CONTENT PROVIDER 


O ContentProvider expõe os dados para as outras aplicações em uma estrutura 
tabular, semelhante às tabelas dos bancos de dados relacionais. Cada linha representa 
uma instância do dado obtido pelo provider e as colunas representam as informações 
referentes àquela instância. 

Para acessar um provedor de conteúdo, utilizamos um objeto do tipo 
ContentResolver que se comunica com o ContentProvider e este, por sua 
vez, recebe a solicitação, executa a ação desejada e retorna os resultados obtidos. As 
operações possíveis de um ContentProvider são as de criar, recuperar, atualizar 
e remover dados. 

Existem três elementos importantes em um ContentProvider: suas Uris, 
as colunas existentes e as permissões necessárias para acessá-lo. 

Uma Uri de conteúdo é uma String formada por um nome simbólico que 
identifica o provedor (a autoridade) e por um caminho (o path) que indica em qual 
tabela os dados estão. Geralmente, os ContentProviders disponibilizam em 
forma de constantes uma Uri diferente para cada tabela que ele expõe. 

Veja um exemplo de Uri, onde com.android.contacts é a autoridade do 
provider e contacts éo path: 


content://com.android.contacts/contacts 


Essa Uri, além de indicar de onde os dados devem ser obtidos, também 
pode conter informações sobre o dado propriamente dito. Por exemplo, um 
ContentProvider pode definir que alguns segmentos da Uri são na verdade pa- 
râmetros da operação que será executada. Isto é bastante comum em Uris utili- 
zadas para recuperar um dado a partir de um id ou para executar uma consulta 
informando um filtro que seja aplicado a várias colunas. Veremos exemplos assim 
mais adiante. 

Uma vez determinada qual é a Uri de acesso, é necessário saber em quais co- 
lunas as informações estão, para que se possam obter os dados. Os provedores de 
conteúdo disponibilizam o nome das colunas existentes também na forma de cons- 
tantes. O provedor de contatos, por exemplo, agrupa todas as suas informações de 
Uris e colunas suportadas, na classe Contact sContract. 

O ContentProvider também define permissões para que possa ser utilizado. 
Isso é especialmente importante, pois geralmente os provedores de conteúdo são 
utilizados para permitir que outras aplicações acessem e alterem dados de outra. 
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Para utilizarmos um ContentProvider em nossa aplicação precisamos incluir as 
permissões adequadas. 

Uma aplicação que pretende, por exemplo, ler e alterar dados de contatos deve 
declarar as seguintes permissões no AndroidManifest.xml: 


<uses-permission android:name="android.permission.READ CONTACTS" /> 
<uses-permission android:name="android.permission.WRITE CONTACTS" /> 


Agora que já temos permissões adequadas, conhecemos a Uri e as colunas que 
compõem a informação desejada, precisamos obter um ContentResolver para 
se comunicar com o ContentProvider. As classes que estendem Context, tais 


como Activity e Service, possuem um método getContentResolver () 





que retornam uma instância deste tipo. 

A partir do ContentResolver, podemos executar consultas, inclusão, alte- 
ração e exclusão de dados, se tivermos as permissões corretas e a operação for su- 
portada pelo provedor. Os resultados recuperados de um ContentProvider são 
retornados em um Cursor. 


5.2 ACESSE OS CONTATOS DO TELEFONE 


O Android disponibiliza um ContentProvider bastante completo para compar- 
tilhar os dados dos contatos armazenados no telefone, cujas informações estão loca- 
lizados em três tabelas principais. 


Na tabela ContactsContract.Contacts temos as informações básicas de 





uma determinada pessoa como nome (coluna DISPLAY NAME), se ela possui tele- 








fone (coluna HAS PHONE NUMBER) eum . ID que pode ser utilizado para recuperar 





os dados desta pessoas nas demais tabelas. Ela funciona como um agrupador já que 
uma pessoa pode ter diversos contatos. 

A tabela ContactsContract.RawContacts relaciona os contatos de uma 
determinada pessoa, que podem ter vindo de serviços de sincronização diferentes 
(Google, Twitter ou outros). Nesta tabela temos duas informações importantes que 
são o nome ( ACCOUNT NAME) e o tipo ( ACCOUNT TYPE) da conta do serviço de 








sincronização. 

Os dados dos contatos são efetivamente armazenados na tabela 
ContactsContract.Data. As demais tabelas existentes são auxiliares e 
ajudam na pesquisa. 

Para executar uma consulta em um ContentProvider devemos fornecer uma 
Uri que indique de onde os dados serão obtidos, uma projeção que representa quais 
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informações devem ser recuperadas, os critérios de filtro e também a ordenação de- 
sejada, de forma bastante semelhante a uma consulta no SQLite. 

Para conseguirmos um Cursor com as informações da tabela Contacts, pri- 
meiro precisamos conseguir o ContentResolver, através do contexto, invocando 
o método getContentResolver (), e em seguida definimos a Uri que devemos 





utilizar para o provider de contatos: 


ContentResolver contentResolver = getContentResolver(); 
Uri uri = Contacts.CONTENT URI; 


O próximo passo é declararmos um array que representa as colunas que devem 
ser retornadas. Neste caso, escolhemos apenas o nome de exibição do contato. Não 
definimos nenhum critério de filtro e nem de ordenação. 


// Recupera o ContentResolver e define a URI 


String[] projection = new String[] ( Contacts.DISPLAY NAME }; 
String selection = null; 

String[] selectionArgs = null; 

String sortOrder = null; 


Por último, invocamos o método que executa a consulta. Como resultado temos 


um Cursor. 


// Recupera o ContentResolver e define a URI 
// Monta as informações para a consulta 


Cursor cursor = contentResolver.query (uri, projection, 
selection, selectionArgs, sortOrder) ; 


Outra operação comum é realizar uma busca parcial, com base no nome do con- 
tato. Para este tipo de consulta existe uma Uri específica, que realiza a busca par- 
cial nos campos que identificam o contato tais como nome, sobrenome, apelido etc. 
Neste caso, utilizaremos uma Uri de filtro na qual adicionamos o critério desejado 
ao final da Uri, como sendo o seu último segmento. 

Para conseguir filtrar todos os contatos que possuem a letra “A” em alguma parte 
do nome e ordenar os resultados de forma ascendente, vamos incluir o critério de 
filtro na ContactsContract.Contacts.CONTENT FILTER URI utilizando o 











método Uri .withAppendedPath para construir a Uri necessária. 
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ContentResolver contentResolver = getContentResolver(); 
Uri uri = Uri.withAppendedPath(Contacts.CONTENT FILTER URI, "A"); 


O resultado dessa operação é uma Uri com o seguinte conteúdo: 
content://com.android.contacts/contacts/filter/A. Repare que 
neste caso não precisamos utilizar os parâmetros selectione selectionArgs 
para executar a consulta visto que o provedor de contatos já disponibiliza uma 
forma específica de fazê-la. 


String[] projection = new String[] ( Contacts.DISPLAY NAME }; 
String selection = null; 

String[] selectionArgs = null; 

String sortOrder = Contacts.DISPLAY_NAME + " ASC"; 


Cursor cursor = contentResolver.query(uri, projection, 
selection, selectionArgs, sortOrder) ; 


Pronto, já temos a consulta pronta. Por fim, vale ressaltar que é obrigatório 
adicionar o critério de filtro na Uri e caso o mesmo não seja informado, este 
ContentProvider lançará uma exceção. 


A fim de facilitar as consultas, o provedor de contatos disponibiliza entidades, 





como Phone e Email, que podem ser entendidas como tabelas geradas a partir 
de joins entre as três tabelas principais. No próximo código, utilizaremos a entidade 
Phone para recuperar os telefones do contato que possui o _ID igual a 10: 


ContentResolver contentResolver = getContentResolver(); 
Uri uri = Phone.CONTENT URI; 


String[] projection = new String[] ( Phone. NUMBER, 

Phone.TYPE }; 
String selection = Phone.CONTACT ID + " = ?"; 
String[] selectionArgs = new String[]{ "10" }; 
String sortOrder = null; 


Cursor cursor = contentResolver.query(uri, projection, 
selection, selectionArgs, sortOrder) ; 


O código é basicamente o mesmo utilizado anteriormente para listar os conta- 
tos, modificamos apenas a Uri e as colunas que agora pertencem à entidade Phone. 
Tanto a entidade Phone quanto a Email possuem uma coluna TYPE que indica o 
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seu respectivo tipo. Para saber mais sobre o ContentProvider de contatos con- 
sulte a documentação 


5.3 CRIE UM CONTENT PROVIDER PARA O SEU APLICATIVO 


O ContentProvider é um importante componente da plataforma Android que 
essencialmente permite o compartilhamento de dados entre as aplicações, disponi- 
bilizando operações de leitura e escrita. Por questões de segurança, por padrão, não 
é possível acessar qualquer tipo de dado que pertença a outra aplicação, seja ele um 
arquivo (de imagem, vídeo, texto etc.) ou um banco de dados SQLite. Não há neces- 
sidade de implementar um provedor de conteúdo se não for necessário compartilhar 
dados com outros aplicativos. 

No entanto, pode haver necessidade de que nosso aplicativo possa transferir ou 
receber dados de outro. Já vimos que é possível passar alguns tipos de dados via 
Intents mas quando o volume de informações é maior e são mais estruturadas, 
isso não é suficiente. A saída existente é implementar um ContentProvider para 
tomar conta dessa comunicação entre aplicativos. 

Como exemplo, suponha que precisamos compartilhar, seja por necessidade 
ou por diferencial, as informações de viagens e gastos com qualquer outra aplica- 
ção. Para isto, criaremos um provedor de conteúdo para o BoaViagem que consiste 
em estender a classe ContentProvider e implementar alguns de seus métodos. 
Além disso definiremos as Uris e as permissões necessárias para acessar o provider. 
Por questões de organização, vamos criar todas as classes relacionadas ao provider 
de conteúdo no pacote br.com.casadocodigo.boaviagem.provider. Crie 
neste pacote uma nova classe chamada de BoaViagemProvider e faça com que 
ela estenda ContentProvider. A seguir está o código da classe com os métodos 


ainda sem implementação. Discutiremos cada um deles logo em seguida. 


public class BoaViagemProvider extends ContentProvider{ 


@Override 
public boolean onCreate() { 
return false; 


@Override 
public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
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return null; 


@Override 
public Uri insert(Uri uri, ContentValues values) { 
return null; 


@Override 
public int delete(Uri uri, String selection, 
String[] selectionArgs) { 
return 0; 


@Override 
public int update(Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
return 0; 


@Override 
public String getType(Uri uri) { 
return null; 


O ContentProvider depende de uma Uri, que além de determinar a opera- 
ção desejada, indica também sobre quais dados ela deve ser executada. 


No nosso caso, iremos disponibilizar cinco Uris com objetivos distintos: 


e Inserção ou pesquisa de viagens; 


Atualização ou remoção de viagens; 


Pesquisa de gastos de uma viagem; 


* Inserção ou pesquisa de um gasto; 


Atualização ou remoção de um gasto. 


Cada Uri deverá possuir um segmento que identifica o provedor, também co- 
nhecido como autoridade (authority), e o path que indicará a localização dos dados. 
Adicionalmente, a Uri pode ter um segmento que indica o _1D do dado desejado. 
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A estrutura da Uri é muito importante e deve ser escolhida com cuidado, pois 
é a partir dela que o provedor tomará as decisões sobre o que executar. 

Para as Uris de viagens, teremos uma para inserir ou pesquisar viagens e a 
outra para atualizar ou remover um registro, sendo necessário, neste último caso, 
informar o . ID da viagem como parte da Uri. Faremos o mesmo para as Uris 
de gastos, além de disponibilizar uma especificamente para recuperar gastos de uma 
determinada viagem. A ideia é que elas sejam assim: 


// inserir ou pesquisar viagens 
content://br.com.casadocodigo.boaviagem.provider/viagem 


// atualizar ou remover viagem 
content://br.com.casadocodigo. boaviagem. provider/viagem/# 


// pesquisar gastos de uma viagem 
content://br.com.casadocodigo. boaviagem. provider/gasto/viagem/# 


// inserir ou pesquisar gastos 
content://br.com.casadocodigo. boaviagem. provider/gasto 


// atualizar ou remover gasto 
content: //br.com.casadocodigo. boaviagem. provider/gasto/# 


O # indica que aquele segmento deve corresponder a uma sequência de caracte- 
res numéricos de qualquer tamanho, ou seja, deve ser um número que representará 
o - ID do dado desejado. 

Uma Uri também pode conter +, que indica que o segmento deve ser uma 
String de qualquer tamanho. Como as boas práticas recomendam, utilizaremos 
constantes para representar as Uris. Também é importante criar constantes que 
representam as colunas que serão recuperadas, tanto para facilitar o uso por terceiros 
quanto para internamente organizarmos o código e assim evitar o uso explícito de 
Stringe Integer 

Vale salientar que essas colunas não são necessariamente as mesmas colunas do 
banco SQLite da aplicação. Podemos expor um conjunto diferente de dados que 
inclusive pode não refletir a estrutura de tabelas existentes no banco de dados. Por- 
tanto lembre-se que apesar da similaridade, o path e as colunas do provider não são 
a mesmas coisas que as tabelas e colunas do banco de dados. 

Crie uma classe BoaViagemCont ract que definirá as colunas e Uris do nosso 
ContentProvider, através de constantes. Ela terá o seguinte código: 
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public final class BoaViagemContract ( 
public static final String AUTHORITY = 
"br.com. casadocodigo.boaviagem. provider"; 
public static final Uri AUTHORITY_URI = 
Uri.parse("content://" + AUTHORITY) ; 
public static final String VIAGEM_PATH = "viagem"; 
public static final String GASTO_PATH = "gasto"; 


public static final class Viagem{ 
public static final Uri CONTENT_URI = 
Uri.withAppendedPath (AUTHORITY URI, VIAGEM PATH); 


public 
public 
public 
public 
public 
public 


static 
static 
static 
static 
static 
static 


final 
final 
final 
final 
final 
final 


"quantidade 


String _ID =" id", 

String DESTINO = "destino"; 

String DATA CHEGADA = "data chegada"; 
String DATA SAIDA = "data saida"; 
String ORCAMENTO = "orcamento"; 
String QUANTIDADE PESSOAS = 
-pessoas"; 


public static final class Gastof{ 


public static final 


public 
public 
public 
public 
public 
public 


static 
static 
static 
static 
static 
static 


Uri 
final 
final 
final 
final 
final 
final 


Uri CONTENT_URI = 

.withAppendedPath (AUTHORITY URI, GASTO PATH); 
String _ID =" id"; 

String VIAGEM ID = "viagem id"; 

String CATEGORIA = "categoria"; 

String DATA = "data"; 

String DESCRICAO = "descricao"; 

String LOCAL = "local"; 


Para criar as Uris utilizamos dois métodos utilitários: o Uri .parse, que cria 


uma Uri válida a partir de uma String, eo Uri.withAppendedPath, que é 


utilizado para incluir um novo segmento a uma Uri existente. 


Quando alguma operação for solicitada para o nosso ContentProvider, pre- 


cisaremos a partir da Uri determinar o que deve ser feito. Para isso, utilizaremos a 


classe utilitária UriMat cher que faz a comparação da Uri informada pelo usuário 


com as Uris definidas, retornando um valor previamente definido indicando qual 


foia Uri em que houve o matching, como a seguir: 
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int VIAGENS = 1; 


UriMatcher uriMatcher = new UriMatcher (UriMatcher.NO MATCH) ; 
uriMatcher.addURI (AUTHORITY, VIAGEM PATH, VIAGENS); 


if (uriMatcher .match(uri) == VIAGENS) { 
// operação de listar viagens 


Neste trecho de código, criamos a UriMatcher e adicionamos a Uri que cor- 





responde à operação de pesquisar viagens. O valor VIAGENS será utilizado para 
comparar o retorno do método UriMatcher.match e, caso sejam iguais, quer di- 
zer que a Uri informada é a de pesquisa de viagens. 

É necessário adicionar ao UriMatcher cada Uri que será utilizada pelo pro- 
vedor. Portanto na classe BoaViagemProvider teremos o código para isso: 


import static br.com.casadocodigo.boaviagem.BoaViagemContract. *; 
public class BoaViagemProvider extends ContentProvider { 
private static final int VIAGENS = 1; 
private static final int VIAGEM_ID = 2; 
private static final int GASTOS = 3; 
private static final int GASTO_ID = 4; 


private static final int GASTOS_VIAGEM_ID = 5; 


private static final UriMatcher uriMatcher = 
new UriMatcher (UriMatcher.NO MATCH); 


statict{ 
uriMatcher.addURI (AUTHORITY, VIAGEM PATH, VIAGENS); 


uriMatcher.addURI (AUTHORITY, VIAGEM PATH + "/#", VIAGEM ID); 
uriMatcher.addURI (AUTHORITY, GASTO PATH, GASTOS); 


uriMatcher.addURI (AUTHORITY, GASTO PATH + "/#", GASTO ID); 





uriMatcher .addURI (AUTHORITY, 
GASTO PATH + "/"+ VIAGEM PATH + "/#", GASTOS VIAGEM ID); 
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// demais códigos existentes 


Assim, adicionamos as cinco Uris que iremos utilizar e poderemos posterior- 
mente invocar o método UriMatcher.match para determinar qual operação deve 
ser realizada. 

Já temos as definições e a estrutura do ContentProvider prontas e 
agora partiremos para a implementação dos seus métodos. Como nossos da- 
dos estão armazenados em um banco SQLite, utilizaremos a nossa classe 
DatabaseHelper para acessá-lo. A sua instanciação será feita no método 


onCreate do BoaViagemProvider. 


private DatabaseHelper helper; 


@Override 

public boolean onCreate() { 
helper = new DatabaseHelper (getContext()) ; 
return true; 


O próximo método a ser implementado é o query, para realizar consultas no 
provedor de conteúdo. A partir da Uri informada como parâmetro, determina- 
remos qual é a consulta que deve ser realizada. Começaremos pelas consultas de 
viagens e vamos precisar de uma instância de SQLiteDatabase, que conseguimos 
através do DatabaseHelper que acabamos de instanciar no método onCreate: 


@Override 
public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 


SQLiteDatabase database = helper.getReadableDatabase() ; 


// as consultas virão aqui 


Agora temos que fazer a comparação da Uri informada com aquelas carregadas 





previamente no UriMatcher. Casoa Uri informada seja a de VIAGENS, execu- 
tamos uma consulta na tabela viagem. 
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switch (uriMatcher.match(uri)) { 


case VIAGENS: 
return database.query(VIAGEM_PATH, projection, 
selection, selectionArgs, null, null, sortOrder) ; 


Aqui, propositadamente fizemos o path coincidir com o nome da tabela 
a que ele se refere. Repare também que os parâmetros recebidos pelo mé- 
todo ContentProvider.query são praticamente os mesmos recebidos pelo 
SQLiteDatabase.query. Então simplesmente repassamos os parâmetros para 
que a consulta seja executada. Lembre-se que em alguns casos pode ser necessá- 
rio validar ou checar os parâmetros recebidos para garantir a execução correta da 
operação. 





Caso a Uri for VIAGEM ID, a nossa consulta deverá ter uma cláusula where 
para restringir a consulta com base no _ID informado. Para isso, recuperamos o 
último segmento da Uri, que representa o _ID do registro, utilizando o método 
uri.getLastPathSegment e executamos a consulta desejada. 

Por fim, no caso da Uri informada não coincidir com nenhuma das definidas 


no UriMatcher, lançamos uma exceção. 


case VIAGEM ID: 
selection = Viagem. ID + " = ?"; 
selectionArgs = new String[] (uri.getLastPathSegment ()+; 
return database.query (VIAGEM PATH, projection, 
selection, selectionArgs, null, null, sortQrder) ; 
default: 
throw new IllegalArgumentException("Uri desconhecida"); 


Agora podemos fazer as consultas para os gastos, que funcionarão de forma si- 
milar às de viagens. Vamos usar as constantes GASTOS e GASTO. ID: 


case GASTOS: 
return database.query (GASTO PATH, projection, 
selection, selectionArgs, null, null, sortOrder) ; 


case GASTO. ID: 
selection = Gasto. ID + " = ?"; 
selectionArgs = new String[] {uri.getLastPathSegment ()}; 
return database.query(GASTO_PATH, projection, 
selection, selectionArgs, null, null, sortOrder) ; 
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utiliza como restrição a VIAGEM ID. Veja então como ficou o código completo 
do método query: 


case GASTOS. VIAGEM ID: 


selection = Gasto.VIAGEM ID + " = ?"; 
selectionArgs = new String[] (uri.getLastPathSegment O); 
return database.query (GASTO PATH, projection, 

selection, selectionArgs, null, null, sortOrder) ; 


A implementação do método insert é bastante simples, pois já recebemos 
como parâmetro um ContentValues que contém os dados que o usuário de- 
seja inserir e também não fazemos nenhuma restrição. Ao contrário do método 
insert do SQLiteDatabase que retorna o _ID do registro inserido, o do 
ContentProvider retorna uma Uri que o representa. Dessa forma, após reali- 


zar a inserção, retornaremos uma Uri contendo o _ID do novo registro. 


@Override 
public Uri insert(Uri uri, ContentValues values) { 


SQLiteDatabase database = helper.getWritableDatabase() ; 
long id; 


switch (uriMatcher.match(uri)) { 


case VIAGENS: 
id = database.insert(VIAGEM_PATH, null, values); 
return Uri.withAppendedPath (Viagem. CONTENT URI, 
String. valueOf (id)); 


case GASTOS: 
id = database.insert(GASTO_PATH, null, values); 
return Uri.withAppendedPath(Gasto.CONTENT URI, 
String.value0f (id)); 
default: 
throw new IllegalArgumentException("Uri desconhecida"); 


A implementação do método update é semelhante à realizada no insert já 
que também temos o ContentValues como parâmetro. A diferença é que recebe- 
mos dois parâmetros a mais que representam a cláusula where da instrução SQL de 


163 


5.3. Crie um Content Provider para o seu aplicativo Casa do Código 








UPDATE, O primeiro parâmetro é uma string com os campos e o segundo é um 
array com os respectivos valores. O método delete também recebe esses dois 
parâmetros além da Uri. 


Agora precisamos adicionar suporte à alteração e exclusão de informações 
de acordo com o . ID. Utilizaremos as Uris que contenham o _ID do dado 
além de substituir os parâmetros recebidos para incluir essa restrição. Para a ex- 
clusão tanto do gasto, quanto da viagem, faremos uso do método delete do 


SQLiteDatabase: 


@Override 


public int delete(Uri uri, String selection, String[] selectionArgs) { 
SQLiteDatabase database = helper.getWritableDatabase() ; 
switch (uriMatcher.match(uri)) { 
case VIAGEM_ID: 


selection = Viagem._ID + " = ?"; 
selectionArgs = new String[] {uri.getLastPathSegment (+; 
return database.delete (VIAGEM PATH, 

selection, selectionArgs) ; 


case GASTO_ID: 


selection = Gasto._ID + " = ?"; 
selectionArgs = new String[] {uri.getLastPathSegment ()}; 
return database.delete(GASTO_PATH, 

selection, selectionArgs) ; 


default: 
throw new IllegalArgumentException("Uri desconhecida") ; 
} 
} 
E para a alteração, temos que chamar o método update do SQLiteDatabase: 
@Override 


public int update(Uri uri, ContentValues values, 
String selection, String[] selectionArgs) { 
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SQLiteDatabase database = helper.getWritableDatabase(); 
switch (uriMatcher.match(uri)) 1 
case VIAGEM_ID: 


selection = Viagem._ID + " = ?"; 
selectionArgs = new String[] {uri.getLastPathSegment ()}; 
return database.update (VIAGEM PATH, values, 

selection, selectionArgs); 


case GASTO ID: 


selection = Gasto. ID + " = ?"; 
selectionArgs = new String[] {uri.getLastPathSegment ()}; 
return database.update(GASTO_PATH, values, 

selection, selectionArgs) ; 


default: 
throw new IllegalArgumentException("Uri desconhecida") ; 


O último método do provedor de conteúdo que deve ser implementado é o 
get Type. Este método deve retornar uma String no formato MIME que repre- 
senta o tipo de dado retornado por uma determinada Uri. Como nosso provider 
lida com tabelas, é necessário retornar um formato MIME específico do Android 
(vendor-specific MIME format). Se nosso ContentProvider utilizasse arquivos, 
poderíamos utilizar os tipos MIME existentes, como por exemplo image/jpeg. 

Em se tratando de tabelas, podemos retornar uma determinada li- 
nha ou um conjunto. O Android disponibiliza respectivamente os tipos 
vnd.android.cursor.item e vnd.android.cursor.dir para estes 
casos. Além disso, também temos que identificar o provider e o tipo do dado 
retornado. Veja como fica a String que representa o tipo MIME das Uris de 
viagem: 


// uma única viagem 


"ynd.android.cursor.item/vnd.br.com.casadocodigo.boaviagem.provider 
/viagem" 
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// uma lista de viagens 


"ynd.android.cursor.dir/vnd.br.com.casadocodigo.boaviagem.provider 
/viagem" 


Estes tipos também devem constar na nossa classe de contrato 
BoaViagemContract. Então vamos incluir mais algumas constantes para 


representá-los: 


public static final class Viagem { 
public static final String CONTENT TYPE = 
"ynd.android.cursor.dir/" + 
"vnd.br.com.casadocodigo. boaviagem. provider/viagem" ; 
public static final String CONTENT_ITEM_TYPE = 
"ynd.android.cursor.item/" + 
"vnd.br.com.casadocodigo. boaviagem. provider/viagem" ; 


// demais constantes 


public static final class Gasto { 
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/"+ 
"vnd.br.com.casadocodigo. boaviagem.provider/gasto"; 
public static final String CONTENT_ITEM_TYPE = 
"ynd.android.cursor.item/" + 
"vnd.br.com.casadocodigo. boaviagem.provider/gasto"; 


// demais constantes 


A implementação do método getType retornará esses tipos de acordo com a 
Uri informada, então precisamos implementar o switch que fará a devolução da 





String adequada referente ao CONTENT TYPE: 








@Override 
public String getType(Uri uri) { 
switch (uriMatcher.match(uri)) { 


case VIAGENS: 
return Viagem.CONTENT_TYPE; 
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case VIAGEM ID: 
return Viagem.CONTENT ITEM TYPE; 


case GASTOS: 


case GASTOS. VIAGEM ID: 
return Gasto.CONTENT TYPE; 


case GASTO ID: 
return Gasto.CONTENT ITEM TYPE; 


default: 
throw new IllegalArgumentException("Uri desconhecida"); 


No caso da Uri ser de GASTOS ou GASTOS VIAGEM ID, o tipo retornado é 











sempre uma lista de gastos, por isso o CONTENT. TYPE deve ser o mesmo, ficando o 
case de GASTOS em branco. Agora que já temos todos os métodos implementados, 





só falta adicionaro ContentProvider no AndroidManifest.xml e ele já estará 
pronto para ser usado! Adicione um elemento <provider>, dessa forma: 


<provider 

android:name=".provider.BoaViagemProvider" 

android: authorities="br.com.casadocodigo.boaviagem.provider" > 
</provider> 


E pronto, acabamos de implementar nosso provider. 


5.4 ADICIONE REGRAS DE PERMISSÃO AO SEU CONTENT- 
PROVIDER 


Por padrão, o ContentProvider não possui nenhum tipo de permissão. Dessa 
forma, qualquer aplicativo pode acessar o provedor e realizar operações, o que pode 
ser algo indesejável, dependendo da circunstância. No entanto, é possível acrescentar 
permissões globais para a leitura e escrita, permissões para apenas algumas tabelas 
ou ainda para alguns registros, ou também combinar todos esses tipos de permissões. 

As permissões são definidas no manifesto juntamente com a declaração do pro- 
vedor e elas também precisam ter um nome único, por isso, utilizamos o nome do 
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pacote em sua composição. 
Para definir uma permissão global para escrita e leitura do nosso provedor, pode- 
mos utilizar o atributo android:permission do elemento <provider>, assim: 


<provider 
android:name=".provider.BoaViagemProvider" 
android:authorities="br.com.casadocodigo.boaviagem.provider" 
android:permission= 
"br.com.casadocodigo.boaviagem.provider.permission.ALL"> 
</provider> 


Para dividir as permissões de leitura e escrita, podemos usar o 


android:readPermissioneo android:writePermission: 


<provider 
android:name=".provider.BoaViagemProvider" 
android: authorities="br.com.casadocodigo.boaviagem. provider" 
android: readPermission= 
"br.com.casadocodigo.boaviagem.provider.permission.READ" 
android:writePermission= 
"br.com.casadocodigo.boaviagem.provider.permission.WRITE"> 
</provider> 


De forma mais específica, podemos utilizar o elemento <path-permission> 
para definir permissões para um determinado path, sendo possível então restringir 
o acesso a tabelas e registros. Desse modo, podemos restringir acesso às viagens: 


<provider 
android:name=".provider.BoaViagemProvider" 
android:authorities="br.com.casadocodigo.boaviagem.provider" > 
<path-permission 
android:path="viagem" 
android:permission= 
"pr.com.casadocodigo.boaviagem.provider.permission.ALL" /> 
</provider> 


O aplicativo que deseja utilizar o BoaViagemProvider deverá incluir, em seu 
respectivo manifesto, as permissões corretas para conseguir acessá-lo. 


5.5 CONCLUSÃO 


Neste capítulo exploramos mais um dos componentes da plataforma, o 
ContentProvider, cuja função principal é o compartilhamento de dados 
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entre aplicações. Entendemos como os provedores de conteúdo funcionam através 
de exemplos de uso do provedor de contatos. Por fim, criamos o nosso próprio 
ContentProvider para o aplicativo BoaViagem, com permissões específicas para 


escrita e leitura. 
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CAPÍTULO 6 


Integração de aplicações Android 
com serviços REST 


Nossa aplicação atingiu um conjunto de funcionalidades razoável, com o qual pode- 
mos cadastrar e pesquisar viagens e gastos. Porém, algumas vezes, funcionalidades 
interessantes acabam indo além dos dados que temos disponíveis em nossa aplica- 
ção. Colocar uma mensagem direto nas redes sociais do usuário e descobrir o que 
as pessoas comentam sobre um determinado assunto são exemplos disso. Como fa- 
zemos para ter os dados dessas aplicações? 

Algo que tem se tornado bastante comum é que as aplicações, tanto web como 
mobile e até mesmo aplicações desktop, utilizem serviços remotos disponibilizados 
por outras aplicações. Os usuários esperam cada vez mais centralização e integração 
de dados, com o intuito de trazer acesso rápido e comodidade, obtendo as informa- 
ções literalmente com a ponta dos dedos. 

Grandes empresas como Facebook, Twitter, Google e Yahoo! disponibilizam 
acesso remoto a seus serviços através de uma API e podemos utilizá-los para en- 
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riquecer nossas aplicações. 
Neste capítulo você aprenderá como consumir serviços remotos em uma aplica- 
ção Android. Aproveitaremos também para aprender mais sobre outros componen- 


tes da plataforma, os Services eos BroadcastReceivers. 





TERMINOLOGIA 


Utilizaremos muitos vezes o termo serviço ao longo deste capítulo 
como sinônimo de serviços remotos e webservices. Para evitar confusão, 
quando estivermos nos referindo ao componente da plataforma Android 


de mesmo nome, utilizaremos o termo service. 











6.1 TRABALHE COM REST E JSON 


Um tipo de webservice em especial tem se consolidado como padrão quando se trata 
de disponibilizar serviços na web. Trata-se dos serviços do tipo REST que possuem 


basicamente cinco premissas: 


e Utilizar os métodos do protocolo HTTP para representar as operações que 
pode ser executadas pelo serviço; 


e Expor as informações através de URLs representativas, similar a uma estrutura 
de diretórios; 


e O serviço não deve armazenar estado entre requisições; 


e Transmitir os dados em formato XML e/ou JSON; 


O uso de hypermedia para representar possíveis transições. 


Como resultado, o que temos então é uma URL que, quando acessada, utilizando 
o método HTTP correto e os parâmetros necessários, retorna dados em formato 
texto. De forma simplista isto é um serviço REST. Esta simplicidade e facilidade per- 
mitem seu uso em praticamente qualquer tipo de plataforma, desde web até mobile. 

Quando pedimos informações para um outro serviço, ele precisa nos transfe- 
rir os dados que pedimos, para que possamos decidir o que fazer com ele em nossa 
aplicação. Para trafegar as informações, poderíamos utilizar tanto o conhecido for- 
mato XML, como o JSON, JavaScript Object Notation, que é um formato simples 
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utilizado para representar dados, voltado principalmente para a conversão de dados 
estruturados para a forma textual. Esse formato é capaz de representar quatro tipos 
primitivos (números, strings, valores booleanos e null) e dois tipos estruturados 
(objetos e arrays). Considerando as informações de um livro, teríamos um JSON 


parecido com o seguinte: 


{ 
"Liro": { 
"titulo": "Introdução ao desenvolvimento Android", 
"editora": "Casa do Código", 
"autores": [ 
"João Bosco 0. Monteiro" 
l, 
"anoPublicacao": 2012 
} 
F 


Vamos levar em consideração um aplicativo para auxiliar o usuário a manter 
registros sobre os livros que ele leu e também dos livros que ele possui. Seria interes- 
sante que o usuário pudesse pesquisar e escolher o livro em vez de ter que cadastrar 
todas as informações do mesmo, tais como título, autor, editora etc. Não seria mais 
simples se existisse um serviço já pronto que através de uma URL, nos fornecesse os 
dados de um determinado livro, num formato simples de processar como o JSON? 

Pois bem, este serviço existe e se chama Google Books API. Você pode acessá- 
lo utilizando o seu próprio navegador, para ver como funciona um serviço REST e 
verificar os dados retornados em formato JSON. Para testar, acesse a seguinte URL: 


https: //www.googleapis.com/books/v1/volumes?q=android 


O resultado obtido é uma lista de livros, contendo titulo, autores, data de publi- 


cação e várias outras informações: 


{ 
"kind": "books#volumes", 
"totalItems": 1253, 
"items": [ 
{ 


"kind": "books#volume", 
"id": "wHigzgAACAAJ", 
"etag": "esMB5pgt+jI", 
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"selfLink": 
"https: //www.googleapis.com/books/v1/volumes/wHigzgAACAAJ", 
"volumeInfo": { 
"title": "Android in Action", 
"authors": [ 
"W. Frank Ableson", 
"Robi Sen", 
"Chris King", 
"C. Enrique Ortiz" 
Do 
"publisher": "Manning Pubns Co", 
"publishedDate": "2011-09-28", 
"description": "Android is a free, open source...", 
"industryIdentifiers": [ 
{ 
"type": "ISBN_10", 
"identifier": "1617290505" 
Fs 
{ 
"type": "ISBN 13", 
"identifier": "9781617290503" 
} 
] 


A Google Books API é bastante poderosa e utilizamos apenas uma das funciona- 
lidades para exemplificar um servico REST. Analisando esse JSON vocé pode achar 
que sera complicado trabalhar com esse formato, mas fique tranquilo, pois o Android 
possui algumas classes como a JSONObject para facilitar o trabalho. Além disso, 
existem outras bibliotecas como a Gson (http://code.google.com/p/google-gson/) do 
próprio Google e a Jackson (http://jackson.codehaus.org/) que trazem ainda mais fa- 
cilidades para a manipulação de dados em formato JSON. 

Agora que já sabemos o básico sobre REST, que tal implementar um aplicativo 
que realiza consultas no Twitter e também notifica quando alguém nos menciona 
em algum tweet? Essa é uma situação interessante pois será construída com imple- 
mentações que são bastante comuns quando se trabalha com serviços REST. 

Por exemplo, utilizaremos tarefas assíncronas, AsyncTasks, do Android para 
realizar requisições HTTP, criaremos threads e realizaremos execuções periódicas 
emum Service do Android. Além disso, utilizaremos um BroadcastReceiver 
para iniciar automaticamente nosso aplicativo quando o dispositivo for iniciado. 
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6.2 CONHEÇA A TWITTER SEARCH API 


Da mesma forma que fizemos com o Google Books API, nosso o primeiro contato 
com a API de busca do Twitter será utilizando o navegador. Acesse a URL abaixo 
que faz uma pesquisa por todos os tweets que mencionam o usuário @android: 


http://search.twitter.com/search. json?q=@android 


O retorno sera em formato JSON, aproximadamente como mostra a imagem 6.1. 
Sao apresentados apenas os tweets mais recentes. Diferentemente do JSON obtido 
da Books API, este nao esta formatado, sendo visualmente dificil de identificar quais 
dados a consulta retornou. 
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Figura 6.1: JSON obtido de uma consulta no Twitter 


Como este é nosso primeiro contato, nao vamos recorrer diretamente para a do- 
cumentação da API que informa quais são todos os dados retornados. Iremos re- 
correr ao site http://www.jsonlint.org, que possui uma funcionalidade interessante 
de validação e formatação de texto em formato JSON. Basta copiar e colar o retorno 
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obtido do Twitter no campo de texto do site e escolher a opção de validação. A ima- 
gem 6.2 mostra como ficou a formatação do resultado da pesquisa anterior. 





som y search. twitter com /searth [8OWLimt ~ The JSON Valle 
+ @ | O jsentincorg vossa 
JSONLint atgo 


The JSON Validator 


“completed_in 0,068, 
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“retresh ur” “singe id=? 1399583544745 98404qe%4dandroid” 
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Validate dem 
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Figura 6.2: JSON obtido de uma consulta no Twitter 


Não entraremos em detalhes sobre todos os atributos e opções de consulta exis- 
tentes. Vamos nos focar em realizar uma pesquisa no Twitter, utilizando os termos 
informados pelo usuário, e também realizar uma busca específica sobre menções a 
um determinado usuário, da forma mais simples possível. Para isto, precisaremos 


utilizar basicamente quatro atributos que são retornados na consulta. Identifique-os 
no JSON obtido: 


e refresh url - URL utilizada para repetir a consulta a partir do último tweet 
recuperado. 


e results - array com os tweets encontrados. 
e from user - usuário que realizou o tweet 


e text - texto do tweet 


176 


Casa do Código Capítulo 6. Integração de aplicações Android com serviços REST 





Caso queira se aprofundar, a documentação completa da Twitter API está dis- 
ponível em https://dev.twitter.com/docs. 


6.3 FAÇA CONSULTAS NO TWITTER 


Já sabemos o necessário para iniciar a implementação da nossa busca no Twitter! 
Crie um novo projeto com o nome de TwitterSearch. Selecione como target 
o Android 2.3 e br.com.casadocodigo.twittersearch como nome do pa- 
cote. Após a criação do projeto, não se esqueça de incluir a permissão para acesso à 


Internet no AndroidManifest.xml: 


<uses-permission android:name="android.permission. INTERNET"/> 





A nossa activity principal tera um layout simples, com um EditText para o 
usuario informar os termos da pesquisa, um Button para disparar a consulta e 
uma ListView para apresentar os resultados, no arquivo main.xml. A imagem 


6.3 mostra como ficará a nossa aplicação. 





Android 





Figura 6.3: Pesquisa no Twitter 
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<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="fill_parent" 
android:layout height="fill parent" 
android:orientation="vertical" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="horizontal" > 


<EditText 
android: id="@t+id/texto" 
android: layout_width="250dp" 
android:layout height="wrap content" 
android: inputType="text" 
android: singleLine="true" /> 


<Button 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:onClick="buscar" 
android:text="Ostring/buscar" /> 
</LinearLayout> 


<ListView 
android: id="@+id/lista" 
android:layout width="wrap content" 
android:layout height="wrap content" > 
</ListView> 


</LinearLayout> 


E precisamos também das mensagens, no arquivo strings .xml. 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app_name">TwitterSearch</string> 
<string name="buscar">Buscar</string> 
</resources> 
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A TwitterSearchActivity, que foi criada juntamente com o projeto, por 
enquanto apenas inicializa as variáveis correspondentes aos widgets e define o mé- 
todo buscar, ficando assim: 


public class TwitterSearchActivity extends Activity { 


private ListView lista; 
private EditText texto; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.main); 


lista = (ListView) findViewById(R.id.lista); 


(EditText) findViewById(R.id.texto) ; 


texto 


public void buscar(View v) { 


Para realizar a consulta no Twitter faremos uma requisição HTTP. No entanto, 
nao devemos (e nem podemos) acessar a rede a partir da thread que esta rodando 
a activity (UI thread). Qualquer tipo de processamento ou operação que seja demo- 
rada não deve ser executada na UI thread, pois isto bloquearia a interface gráfica 
e poderia causar o erro de Application Not Responding (ANR). 

Especificamente no caso de acesso à Internet a partir da thread principal, o 
Android lança uma exceção e não permite a realização da operação. 

Para essa situação, o Android disponibiliza através da classe AsyncTask uma 
forma simples de criar tarefas assíncronas que executam operações em background 
(em outra thread) e que podem publicar os resultados da operação na UI thread. 
Iremos utilizá-la para realizar a busca no Twitter, atualizar a nossa ListView e 
controlar um ProgressDialog. A AsyncTask é uma classe genérica e utiliza 
três tipos: 


e Params - é o tipo dos parâmetros que são enviados para a execução da tarefa. 
Por exemplo, pode ser uma String que representa a URL da pesquisa que 
deve ser realizada. 
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1) 


3) 


4) 


* Progress - éo tipo que representa a unidade de progresso da tarefa. Pode ser 
O Integer, representando a porcentagem de progresso de uma operação de 
download ou ainda uma classe sua que contenha outros atributos que possam 


realizar esta indicação. 


e Result - éo tipo de retorno da operação realizada. Pode serum array com 
todos os tweets obtidos na consulta, por exemplo. 


Quando uma AsyncTask é executada, ela percorre quatro etapas (métodos): 


onPreExecute - invocado na UI thread antes da tarefa ser executada. Neste 





passo geralmente preparamos a execução da operação, o que pode, por exemplo, 
incluir a exibição deum ProgressDialog. 


doInBackground - é invocado em uma outra thread e é onde a operação deve 
ser implementada. Este método recebe os Params definidos pela AsyncTask 
e retorna os resultados da operação como sendo do tipo Result. Neste método 
podemos invocar o publishProgess para informar o andamento da operação. 


onProgressUpdate - este método é invocado na UI thread após o 
publishProgress ser executado. Aqui podemos utilizar o valor (do tipo 
Progress) informado para fazer possíveis atualizações de tela, como por exem- 


plo atualizar o progresso de um ProgressBar. 


onPostExecute - também invocado na UI thread, este método recebe o 





Result como parâmetro e faz as atualizações de tela necessárias, como fechar 
o ProgressDialog e atualizar uma ListView com os dados obtidos do mé- 


todo doInBackground. 


O único método que devemos obrigatoriamente implementar quando estende- 


mos a classe AsyncTask éo doInBackground. 


Dentro da TwitterSearchActivity, vamos criar uma classe privada que 


estende de AsyncTask, para invocar o serviço do Twitter, chamada TwitterTask. 


Durante esta operação, vamos exibir um ProgressDialog na tela e ao final do 


processamento iremos atualizar a ListView com os tweets encontrados. A imagem 


6.4 demonstra como ficará a nossa caixa de diálogo informando que a operação está 


em andamento. 
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Figura 6.4: Pesquisa no Twitter 


Começamos com a declaração da classe, definindo que o Params é do tipo 
String, pois iremos passar os termos da pesquisa que deve ser realizada. Já o 
Progress é definido como Void, ou seja, não faremos a atualização de progresso, 
e o tipo de retorno é um String[] com os tweets encontrados. 


private class TwitterTask extends AsyncTask<String, Void, String[]> { 





No método onPreExecute exibimos um ProgressDialog simples e no 
onPostExecute fechamos este dialog após construir um ArrayAdapter com os 





resultados e atribuí-lo a nossa ListView. 


private class TwitterTask extends AsyncTask<String, Void, String[]> { 


ProgressDialog dialog; 
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@Override 

protected void onPreExecute() { 
dialog = new ProgressDialog(TwitterSearchActivity.this) ; 
dialog. show() ; 


@Override 
protected void onPostExecute(String[] result) { 
if(result != null){ 
ArrayAdapter<String> adapter = 
new ArrayAdapter<String>(getBaseContext(), 
android.R.layout.simple_list_item_1, result); 
lista. setAdapter (adapter); 


} 


dialog.dismiss(); 


Para implementar o método doInBackground, precisamos realizar uma re- 
quisição HTTP para uma URL, que será montada a partir dos termos de busca in- 
formados como parâmetro e em seguida, processaremos a reposta obtida que está 
em formato JSON, criando um String[] com os dados dos tweets. 

Como fazer uma requisição HT'TP e capturar a resposta são tarefas corriqueiras, 
vamos criar uma classe, chamada HTTPUtils para encapsular esta implementação. 

Nesta classe teremos um método chamado acessar, que recebe uma String 
como parâmetro que é a URL desejada e retorna uma String que é o conteúdo 
obtido como resposta da solicitação. 

Na sua implementação, abrimos uma conexão a partir do endereço informado e 
nas linhas seguintes fazemos a leitura dos dados recebidos utilizando um Scanner. 


public class HTTPUtils { 
public static String acessar(String endereco){ 
try { 
URL url = new URL(endereco) ; 


URLConnection conn = url.openConnection() ; 


InputStream is = conn.getInputStream() ; 
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Scanner scanner = new Scanner(is); 

String conteudo = scanner.useDelimiter("\\A") .next() ; 
scanner.close() ; 

return conteudo; 


} catch (Exception e) { 
return null; 


Agora precisamos implementar o método doInBackground na nossa 
AsyncTask chamada TwitterTask. 


@Override 
protected String[] doInBackground(String... params) { } 


Precisamos fazer uma validação simples, para evitar a realização de consultas 
sem que os termos desejados tenham sido informados. Em seguida, utilizamos o 
método Uri.parse para construir uma URL válida já incluindo os termos da pes- 
quisa. Este cuidado é necessário pois alguns caracteres devem ser convertidos para 
formar uma URL válida — é o caso do @ que setransformaem %40 edo espaço 
em branco que se torna %20 . E também chamamos o método acessar, para 
recuperarmos o conteúdo da URL. 


@Override 
protected String[] doInBackground(String... params) { 
try { 
String filtro = params[0]; 


if (TextUtils.isEmpty(filtro)){ 
return null; 
String urlTwitter = "http://search.twitter.com/search. json?q="; 


String url = Uri.parse(urlTwitter + filtro) .toString() ; 


String conteudo = HTTPUtils.acessar (url); 
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// vamos usar o conteúdo 
} catch (Exception e) { 
throw new RuntimeException(e); 


Depois de invocar o método HTTPUtils.acessar, criamos um JSONObject 
a partir do conteúdo recebido do serviço. Através dele poderemos acessar os atribu- 
tos desejados sem precisar manipular as Strings da resposta. Em seguida, utiliza- 
mos o método get JSONArray informando o atributo ("results") que armazena 
os tweets em formato de array. 


@Override 
protected String[] doInBackground(String... params) { 
try { 
String filtro = params[0]; 


if (TextUtils. isEmpty (filtro) ){ 
return null; 


String urlTwitter = "http://search.twitter.com/search.json?g="; 
String url = Uri.parse(urlTwitter + filtro) .toString() ; 


String conteudo = HTTPUtils.acessar(url); 


// pegamos o resultado 

JSONObject json0bject = new JSONObject (conteudo) ; 

JSONArray resultados = json0bject.getJSONArray ("results"); 
} catch (Exception e) { 

throw new RuntimeException(e); 


Para cada resultado obtido, criamos um novo JSONObject para recuperar os 
dados específicos que desejamos de cada tweet, que são o seu texto e o usuário que 
o realizou. Após extrair esses dados, eles são armazenados em uma String[] que 
é retornada para ser colocada na ListView. 


@Override 
protected String[] doInBackground(String... params) { 
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try { 
String filtro = params[0]; 


if (TextUtils.isEmpty (filtro) ){ 
return null; 


String urlTwitter = "http://search.twitter.com/search. json?q="; 
String url = Uri.parse(urlTwitter + filtro) .toString() ; 


String conteudo = HTTPUtils.acessar (url); 


// pegamos o resultado 
JSONObject json0bject = new JSONObject (conteudo); 
JSONArray resultados = json0bject.get JSONArray ("results"); 


// montamos o resultado 
String[] tweets = new String[resultados.length()]; 


for (int i = 0; i < resultados.length(); i++) { 
JSONObject tweet = resultados.getJSONObject (i) ; 
String texto = tweet.getString("text") ; 
String usuario = tweet.getString("from_user") ; 
tweets[i] = usuario + " - " + texto; 


return tweets; 
} catch (Exception e) { 
throw new RuntimeException(e) ; 


Para finalizar, agora precisamos iniciar a execução da TwitterTask quando o 
botão buscar for pressionado, veja: 


public void buscar(View v) { 
String filtro = texto.getText() .toString() ; 
new TwitterTask() .execute(filtro) ; 


Agora é só executar a aplicação e testar! A imagem 6.5 mostra os resultados de 
uma pesquisa por Gandroid. Para saber mais sobre a API de pesquisa do Twitter 
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visite https://dev.twitter.com/docs/using-search. 


3% wl Æ 15h58 


a ade ai 


@android 


MISTERDEEIAM - RT @Android: 
Signing into your Google 
Account lets you wirelessly 
sync and backup your contacts, 
photos, calendar, and more: 
http://t.co/rC49KPUx 


MISTERDEEIAM - RT @Android: 
An update to Google+ for 
#Android is now available on 
Google Play: http://t. 
co/4Rf3v7CQ 

MISTERDEEIAM - RT @Android: 
ICS won Gold for Best System 
Experience at the 2012 UX 
Awards. Congratulations to the 
#Android Design team on the 





Figura 6.5: Pesquisa no Twitter 


6.4 IMPLEMENTE UM SERVICO DE BACKGROUND 


A primeira parte do aplicativo TwitterSearch esta pronta. O objetivo desta seção 
é criar um serviço de background que faz pesquisas periódicas no Twitter em busca 
de menções ao seu usuário. Quando uma nova menção for encontrada, criaremos 
uma notificação na barra de status do dispositivo para alertar o usuário. 

O Service é um componente da plataforma Android que pode executar ta- 
refas de longa duração em plano de fundo e que não possui interface gráfica. Ele 
pode ser iniciado por qualquer outro tipo de componente (uma Activity ou outro 
Service, por exemplo) e pode continuar em execução mesmo que o componente 
que o iniciou seja destruído. Alguns exemplos de uso de Service incluem fazer 
downloads, tocar uma música e acessar um serviço remoto. 


Por padrão, o Service é executado no mesmo processo e na thread princi- 
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pal da aplicação. Portanto, se ele realiza operações bloqueantes, o desempenho da 
aplicação pode ficar comprometido, sendo necessário criar no Service uma nova 
thread para executar essas operações. 

Um Service pode assumir duas formas, startede bound, que têm relação 
com a forma como o mesmo é iniciado. 

Um Service é started quando foi iniciado explicitamente por algum ou- 
tro componente através do método Context.startService. Neste caso, o 
Service é executado em plano de fundo indefinidamente mesmo que o compo- 
nente que o iniciou seja destruído. Este tipo de Service é geralmente utilizado 
para realizar operações que não retornam resultados para quem o invocou. Quando 
a operação finalizar, o Service% deve parar a si mesmo utilizando o método 
stopSelf. 

Ele é bound quando foi iniciado por um componente através do método 
Context .bindService. Esta forma de Service permite a interação entre com- 
ponentes, como o envio de requisições e obtenção de respostas, numa espécie de 
cliente-servidor. Deste modo também é possível realizar a comunicação entre pro- 
cessos (IPC). Vários componentes podem fazer bind para o mesmo Service que 
continuará existindo enquanto houver clientes (componentes) conectados. 

O service mais adequado para a nossa necessidade de fazer pesquisas no Twit- 
ter em plano de fundo é o started pois, uma vez iniciado, ele será executado inde- 
finidamente além de não retornar dados para o componente que o invocou. A ideia 
é que a cada menção no Twitter, o Service crie notificações na barra de status para 
alertar o usuário. Para realizarmos esta implementação, criamos uma nova classe 


chamada NotificacaoService, estendendo de android.app.Service 


public class NotificacaoService extends Service{ 
@Override 
public IBinder onBind(Intent intent) { 
return null; 


O método onBind deve ser implementado. Esse método é invocado quando 
algum componente deseja realizar o bind com este Service e deve retornar uma 
implementação de IBinder que será a interface utilizada para a comunicação en- 
tre os componentes. Como no nosso caso não permitiremos o bind, pois nosso 
Service é started, o método onBind retorna null. Precisamos então so- 
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brescrever o método onStart Command que responde quando algum componente 


iniciao Service através do método Context .startService 


@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
//nossa implementação será feita aqui 
return START STICKY; 


O método onStart Command retorna um int que indica como o serviço deve 
ser reiniciado pelo Android quando, por algum motivo, ele for encerrado. O Android 
pode encerrar (kill) um Service, caso o sistema esteja com falta de recursos, e 
recriá-lo posteriormente. A flag START STICKY indica que o Service deve ser 
reiniciado e o método onStartCommand deve ser invocado novamente, mesmo 
que não haja nenhuma Intent pendente de processamento. 

Existem outras flags como a START NOT STICKY, que indica que 
o Service só deve ser reiniciado se houver Intents pendentes, e a 




















START REDELIVER INTENT para que o Service seja reiniciado com a úl- 
tima Intent enviada. 

No método onStartCommand devemos criar uma nova thread para reali- 
zar a consulta por menções no Twitter e fazer com que ela seja executada periodi- 
camente, de 10 em 10 minutos, por exemplo. Para fazer isto, utilizaremos a classe 





ScheduledThreadPoolExecutor que permite que uma instância de Runnable 
seja executada de tempos em tempos apenas configurando a sua execução, utilizando 
o método scheduleAtFixedRat 








Então, instanciaremos um novo ScheduledThreadPoolExecutor passando 
no seu construtor a quantidade de threads que devem ser mantidas no pool. No 
nosso caso, apenas uma thread basta. Nas linhas seguintes definimos qual será o 
atraso (delay) inicial para o início da execução, 0 indica que a execução deve iniciar 
imediatamente. 

Em seguida definimos o período de tempo para que a operação seja realizada. 
Escolhemos que a thread deve ser executada de 10 em 10 minutos. Obviamente 
que em cenários mais reais provavelmente este valor será configurado pelo usuário 
e lido das SharedPreferences. E por fim, fazemos o agendamento da execução 
da NotificacaoTask que é uma classe privada que definiremos a seguir. 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 
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ScheduledThreadPoolExecutor pool = 

new ScheduledThreadPoolExecutor (1); 
long delayInicial = 0; 
long periodo = 10; 
TimeUnit unit = TimeUnit.MINUTES; 
pool.scheduleAtFixedRate(new NotificacaoTask(), 

delayInicial, periodo,unit); 

return START STICKY; 


Agora precisamos implementar a NotificacaoTask, que será responsável por 
realizar a tarefa. Ela implementará a interface Runnable, o que torna possível que 





ela seja executada pelo ScheduledThreadPoolExecutor. 

A implementação do método run é bastante parecida com a que já realizamos 
para buscar os resultados no Twitter, a partir dos termos informados pelo usuário. 
Vamos então às diferenças. Definimos uma variável com os termos que devem ser 
utilizados na primeira vez que a pesquisa for realizada. Inclua o seu usuário do Twit- 
ter lá e depois, acrescentamos um método que verifica se há conectividade para dar 
prosseguimento à execução do método, chamado estaConectado, que implemen- 


taremos em seguida. 


private class NotificacaoTask implements Runnable { 


private String baseUrl = "http://search.twitter.com/search. json"; 
private String refreshUrl = "?q=<seu_usuario_no_twitter>"; 
@Override 


public void run() { 


if (!estaConectado()) { 
return; 

+ 

try { 
String json = HTTPUtils.acessar (baseUrl + refreshUrl); 
JSONObject json0bject = new JSONObject(json); 
refreshUrl = json0bject.getString("refresh url"); 


JSONArray resultados = json0bject.getJSONArray ("results"); 


for (int i = 0; i < resultados.length(); i++) { 
JSONObject tweet = resultados. getJSONObject (i); 
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String texto = tweet.getString("text"); 
String usuario = tweet.getString("from user"); 


criarNotificacao (usuario, texto, i); 


} 
} catch (Exception e) {} 


Quando uma pesquisa é realizada, o Twitter retorna uma URL de atualização, 
contendo a pesquisa original e um parâmetro since id que indica qual foi o 
último resultado retornado. Então na NotificacaoTask atualizamos a variável 
refreshUrl para realizar as consultas posteriores, obtendo apenas as novas men- 
ções. Os resultados obtidos são percorridos e para cada um deles é criada uma nova 
notificação. Veremos como fazer isso na seção seguinte. 

Agora precisamos implementar o método estaConectado, que através do 
ConnectivityManager poderá obter informações variadas sobre o estado das co- 
nexões, sejam elas WI-FI, 3G etc. No nosso caso, recuperamos as informações da 
conexão ativa e na linha seguinte retornamos o valor que indica se o dispositivo está 
ou não conectado a uma rede de dados. 


public class NotificacaoService extends Service 1 
//demais códigos existentes 
private boolean estaConectado() 1 
ConnectivityManager manager = 
(ConnectivityManager) getSystemService( 
Context .CONNECTIVITY SERVICE); 


NetworkInfo info = manager.getActiveNetworkInfo(); 


return info. isConnected(); 


Agora, para ficar completo, precisamos implementar o método 


criarNotificacao 
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6.5 CRIE NOTIFICAÇÕES NA BARRA DE STATUS 


A barra de status do Android é o local onde as notificações são exibidas. Essas noti- 
ficações podem ser do próprio sistema, como por exemplo um aviso sobre o descar- 
regamento da bateria, ou podem ter sido criadas por qualquer aplicativo. 

A figura 6.6 mostra como deve ficar as notificações do nosso aplicativo 
TwitterSearch na barra de status. Quando o usuário selecionar alguma das no- 
tificações, devemos mostrar o tweet em uma nova activity da nossa aplicação. A 
imagem 6.7 mostra uma visualização simples do tweet. 


17 de junho de 2012 


le vangeransaragih mencionou você 
Tor-tor is taditional dance from Indonesi: 11h01 


i) EbrahimM mencionou você 
@Android @google is the 4.04 update the 1 


cp WebsoullT mencionou vocé 


RT @Android: What do bananas &amp; n 11 


(o zzz8307 mencionou você 
@Android @applenws @appletweets DE- 11 


ry dudeonomix mencionou vocé 
QJust Dial the @Android app doesn't sho 11 


iG) Jtogg mencionou você 
@Android why does my HTC EVO keep lo: 1 








Figura 6.6: Notificações na barra de status 
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Ahmadbanafe 


(WAndroid 4 Arab GAndroid QAndroid Man. 

Jals dugj Ap! api! água aplyja cá Jo 
älJėui nguung Gey ba jload! gid jload! 
angh lodio 





Figura 6.7: Notificações na barra de status 


Para construir as notificações, implementamos na classe 
NotificacaoService o método criarNotificacao. Este método re- 
cebe como parâmetro o texto do tweet e o usuário que o realizou, além de um 
identificador para a notificação. 


O método vai receber o usuário, o texto e o id do tweet: 


private void criarNotificacao(String usuario, String texto, int id) É 


Definimos qual sera o icone da notificação, recuperamos do strings.xml o 
texto que irá aparecer na barra de status, obtemos um long que representa a data 
da notificação além de construir o título da notificação que será algo como “alguém 
mencionou você. Em seguida, criamos uma Intent que será utilizada para iniciar 
uma activity que exibirá os dados do tweet, incluídos como extras da Intent. 
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Utilizaremos a PendingIntent para iniciar a TweetActivity quando o 
usuário selecionar uma notificação. Basicamente a PendingIntent permite que 
outro componente execute a ação definida anteriormente pela Intent como se fosse 
a própria aplicação que a criou. Utilizaremos este recurso para vincular cada notifi- 
cação a uma Intent que exibe os dados do tweet. 


private void criarNotificacao(String usuario, String texto, int id) É 
int icone = R.drawable.ic_launcher; 
String aviso = getString(R.string.aviso) ; 
long data = System.currentTimeMillis() ; 
String titulo = usuario + " " + getString(R.string.titulo) ; 


Context context = getApplicationContext () ; 

Intent intent = new Intent(context, TweetActivity.class) ; 
intent .putExtra(TweetActivity.USUARIO, usuario.toString()) ; 
intent .putExtra(TweetActivity.TEXTO, texto.toString()); 


PendingIntent pendingIntent = 
PendingIntent.getActivity(context, id, intent, 
Intent.FLAG ACTIVITY NEW TASK); 


Criamos uma PendingIntent, recebendo como parâmetro o contexto, um 
identificador para a requisição (atualmente não utilizado pelo Android), a Intent 
desejada e uma flag de inicialização. 


Agora, vamos criar uma nova notificação com o ícone, o texto de aviso e a data 





previamente definidos. Utilizaremos a flag FLAG AUTO CANCEL para indicar que, 
ao ser selecionada esta notificação, iremos sair da lista de notificações. Adicional- 
mente configuramos para que a notificação provoque a vibração do dispositivo, to- 
que o som padrão e ainda ative a iluminação de aviso. 





Vamos usar o método setLatestEvent Info para incluir as informações da 
notificação que são o usuário e texto do tweet ea PendingIntent que será execu- 
tada. Agora que a notificação está pronta, utilizamos o NotificationManager 
para efetivamente a colocar na barra de status. 


private void criarNotificacao(String usuario, String texto, int id) É 
// Recupera as informações e cria a PendingIntent 


Notification notification = new Notification(icone, aviso, data); 
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notification.flags = Notification.FLAG AUTO CANCEL; 
notification.flags = Notification.FLAG AUTO CANCEL; 
notification.defaults |= Notification.DEFAULT VIBRATE; 
notification.defaults |= Notification.DEFAULT LIGHTS; 
notification.defaults |= Notification.DEFAULT SOUND; 
notification.setLatestEventInfo(context, titulo, 


texto, pendingIntent); 


String ns = Context .NOTIFICATION SERVICE; 

NotificationManager notificationManager = 
(NotificationManager) getSystemService(ns); 

notificationManager.notify(id, notification); 


Precisamos colocar também as mensagens no strings .xml. 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app_name">TwitterSearch</string> 
<string name="buscar">Buscar</string> 
<string name="aviso">Vocé foi mencionado!</string> 
<string name="titulo">mencionou vocé</string> 
</resources> 


A activity criada para a exibição dos tweets é bastante simples e não possui nada 
de diferente do que já foi apresentado no decorrer no livro. Confira o arquivo de 
layout tweet . xml: 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:orientation="vertical" > 


<TextView 
android:id="@+id/usuario" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


<TextView 


android:id="@+id/texto" 
android:layout_width="wrap_content" 
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android:layout height="wrap content" /> 


</LinearLayout> 


Eaclasse TweetActivity: 


public class TweetActivity extends Activity { 
public static final String TEXTO = "texto"; 
public static final String USUARIO = "usuario"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState) ; 
setContentView(R.layout.tweet) ; 


TextView usuarioTextView = 
(TextView) findViewById(R.id.usuario) ; 
TextView textoTextView = (TextView) findViewById(R.id.texto) ; 


String usuario = getIntent () .getStringExtra (USUARIO) ; 
String texto = getIntent ().getStringExtra(TEXTO); 


usuarioTextView.setText (usuario); 
textoTextView.setText (texto); 


Para finalizar a implementação do Service e das notificações, é necessário de- 
clararo Service no AndroidManifest.xml, assim como a TweetActivity. 
Também é preciso inserir uma permissão referente ao acesso às informações de rede 
e outra para ativar a vibração do dispositivo. Veja como ficou: 


<!-- permissões necessárias --> 

<uses-permission android:name="android.permission. INTERNET" /> 

<uses-permission 
android:name="android.permission.ACCESS. NETWORK STATE" /> 

<uses-permission android:name="android.permission.VIBRATE"/> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 


<!-- declarações existentes --> 
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<service android:name=".NotificacaoService" /> 
<activity android:name=".TweetActivity" /> 
</application> 


Ainda não é possível ver o serviço implementado executando pois 
em nenhum momento fizemos a sua inicialização chamando o método 
Context.startService. A ideia é que isto não seja feito pelo usuário e 
sim pelo próprio Android quando o dispositivo foi iniciado. 


6.6 UTILIZE UM BROADCAST RECEIVER PARA INICIAR O 
SERVICE 


A última parte da nossa aplicação que utiliza o twitter, consiste em implementar um 
outro tipo de componente do Android, chamado de Broadcast Receiver. Este compo- 
nente pode responder a eventos propagados (broadcasts) pelo sistema e também por 
outros aplicativos. Assim como o componente Service, 0 BroadcastReceiver 
também não possui interface gráfica e geralmente interage com o usuário através de 
notificações. 

Faremos uma implementação que representa bem o papel do 
BroadcastReceiver, que é receber um evento e processá-lo, geralmente 
delegando a execução para outro componente. 

Crie uma nova classe com nome de StartupReceiver, estendendo de 
BroadcastReceiver. Temos que implementar apenas o método onReceive que 
recebe como parâmetro o contexto e o evento que na verdade é uma Intent, algo 
que já conhecemos bem. Nesse método iniciaremos o NotificacaoService. O 


código a seguir demostra a implementação do StartupReceiver. 


public class StartupReceiver extends BroadcastReceiver{ 
@Override 
public void onReceive(Context context, Intent intent) { 
Intent it = new Intent(context, NotificacaoService.class) ; 
context.startService(it) ; 


No nosso caso, o evento que queremos capturar é o 











android. intent.action.BOOT COMPLETED que indica que o dispositivo 





foi inicializado. Como os eventos na verdade são Intents fica fácil ima- 
ginar que precisaremos incluir um intent filter para capturá-los. No 
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AndroidManifest.xml faremos a declaração do BroadcastReceiver e do 
filtro necessário, além, é claro, de uma permissão para receber o evento, dessa 
forma: 


<!-- permissões já existentes --> 
<uses-permission 
android:name="android.permission.RECEIVE BOOT COMPLETED" /> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<!-- declarações existentes --> 
<receiver android:name=".StartupReceiver" > 
<intent-filter> 
<action 
android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 
</application> 


Agora a aplicação TwitterSearch está pronta! Execute-a normalmente. 

Na primeira execução, o ADT irá instalar o aplicativo, no entanto, o evento de 
boot já foi disparado e então o aplicativo não irá iniciaro Service. Feche o emula- 
dor e o inicie novamente, mas desta vez pelo AVD Manager (menu Window -> AVD 
Manager, opção start ). Agora o serviço deve ser iniciado, e para testar basta 
tuitar algo com os termos que você especificou. 





VERIFICANDO SERVIÇOS EM EXECUÇÃO 


No Android é possível verificar quais aplicativos e serviços es- 
tão sendo executados através do menu Configurações, opção 





Aplicativos, aba Em execução. 











6.7 CONCLUSÃO 


Acabamos de aprender um pouco dos serviços REST que utilizam o formato JSON 
para transmitir dados. Experimentamos a Google Books API que disponibiliza in- 
formações sobre livros através de um serviço REST e implementamos uma aplicação 
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de exemplo que realiza buscas no Twitter e faz notificações quando alguém nos men- 
ciona em algum tweet. 

Para as implementações, utilizamos AsyncTask e os componentes Service 
e BroadcastReceiver da plataforma Android, além de agendar a execução de 
threadcomo ScheduledThreadPoolExecutor. Todos estes itens são frequen- 





temente utilizados quando trabalhamos com serviços remotos. 

Você pode aprender muito mais sobre REST através de livros específicos, como o 
RESTful Web services, do Leonard Richardson e Sam Ruby, ou então, através do bom 
material disponibilizado pela IBM, em seu blog de desenvolvedores: http://www. 
ibm.com/developerworks/webservices/library/ws-restful. 
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CAPÍTULO 7 


Utilize Google APIs e crie 
funcionalidades interessantes 


No capitulo 6, fizemos a integração com o twitter e criamos uma aplicação que notifi- 
cava o usuário a cada novo tweet que surgisse sobre um determinado assunto. Mas e 
se quisermos colocar em nossa aplicação um serviço de calendário, para podermos 
guardar em nossas agendas as viagens que teremos que fazer? Como poderíamos 
implementar essa funcionalidade? 

O Google disponibiliza diversos serviços relacionados aos seus produtos que po- 
dem ser utilizados gratuitamente por nós, desenvolvedores. Esses serviços também 
são conhecidos como Google APIs. Alguns exemplos são a Places API que permite 
obter informações sobre determinada localidade, a Tasks API que permite interações 
com o Google Tasks, a Google Maps API além da Drive API para integração com o 
Google Drive. 

De forma geral, estes serviços podem ser acessados diretamente via HT'TP, sendo 
responsabilidade do aplicativo cliente realizar os procedimentos de autenticação, 
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executar a requisição e processar a resposta do serviço. No entanto o Google disponi- 
biliza uma série de bibliotecas, em diversas linguagens de programação, conhecidas 
como Google APIs Client Libraries, que facilitam o uso desses serviços. 

Neste capítulo veremos como utilizar uma conta do Google para autenticar um 
usuário e incluiremos essa funcionalidade no login do nosso aplicativo BoaViagem. 
Além disso, faremos uma integração do aplicativo com a agenda do usuário no Go- 
ogle Calendar. Assim que ele criar uma nova viagem, registraremos em sua agenda 
um novo evento compreendendo as datas da viagem usando a Calendar API. Para 
realizar essas implementações são necessários alguns procedimentos de preparação, 
que veremos nas seções seguintes. 





NÃO CONHECE O GOOGLE CALENDAR? 


O Google Calendar, ou Google Agenda como é chamado no Brasil, 
é um serviço gratuito, com interface web, no qual é possível registrar e 
controlar eventos e compromissos além de poder compartilhá-los com 
outras pessoas. Para utilizar o serviço é necessário uma conta do Google. 
Conheça o serviço em http://www.google.com/calendar 











7.1 INSTALE O ADD-ON GOOGLE APIs 


O add-on Google APIs é uma extensão do Android SDK que disponibiliza essenci- 
almente uma API externa para trabalhar com mapas além de outros componentes 
e serviços do Google que rodam no Android. No nosso caso, estamos interessados 
no serviço de contas de usuário que utilizaremos para autenticação. É importante 
ressaltar que este add-on nada tem a ver com os diversos serviços disponibilizados 
pelo Google, tais como a Google+ API, Calendar API e CustomSearch API, e as suas 
respectivas bibliotecas de acesso. 

Para realizar o download, acesse o Android SDK Manager através do menu 
Window -> Android SDK Manager do Eclipse, selecione e instale o add-on Go- 
ogle APIs da versão 2.3.3 que estamos utilizando, conforme demonstra a imagem 
Zi 
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so a oe : — Android SDK Manager, 


SDK Path: /tsers/joao/Dev/android-sdk-mac_x86/ 





Packages 
Name 
PL Tools 
im) Android 4.0.3 (API 15) 
b |S) Android 4.0 (API 14) 
> [5 Android 3.2 (API 13) 
P LSJ Android 3.1 (API 12) 
> [5 Android 3.0 (API 11) 
Y (a) Android 2.3.3 (API 10) 
WW SDK Platform dB installed 
ÉS Samples for SDK I installed 


opone 


GOpOnRKIIOOI 


+ Nor installed 
+ Not installed 
+ Not installed 
Ẹ Not installed 
+ Not installed 
+ Not installed 
+ Not installed 
Ẹ Not installed 
+ Not installed 
+ Not installed 


“Ep OpenSense SDK for Phones 
iğġ Intel Atom x86 System Image 
"fy. Dual Screen APIs 

i Real3D 

‘ADMIRAL 

'RLATRIX2 

"Bionic 

im defy+ 

‘@ Droid4 

iğ DroidRAZR 

a p 


Motoro 


| 
Did 
LJ 
Te 
O 
e | 
Oo 
| 
J 
J 


tm My da by dy YN da das dy 


Tainini 


Show: {4 Updates/New [M Installed || Obsolete Select New or Updates Install 2 packages... | 


Sort by: (*) API level |) Repository Deselect All Delete 1 package... | 





m E 


Done loading packages. 


Figura 7.1: Download do pacote Google APIs 


Depois que o pacote for instalado, vamos criar um novo AVD compatível com 
a Google APIs. Acesse o menu Window -> AVD Manager do Eclipse, e selecione 
a opção New... na janela que irá surgir. A imagem 7.2 mostra como configurar o 
novo AVD. 
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| 8,0 Create new Android Virtual Device [AVD} 
List of existing Android Virtual Devices located at /Users/joao/.android/avd Name: Phone2 
AVD Name Target Name Platform API Level CPU/ABI New.. | 
~~ Phonel Android 2.3.3 233 10 ARM (armeabi) Target | Google APIs (Google Inc.) — API Level 10 | 
CPU/ABI Vat 
SD Card. = 
fas Size Mia ip 
File B 
Snapshot 
F: Enabled 
Skin -= 
(© Built-in: Default (WVGA800) 


‘_) Resolution: x 


Hardware: 


Property Value New. 
Abstracted LCD density 240 

Max VM application hea.. 24 

Device ram size 256 


Refresh 
~ Avalid Android Virtual Device. |) A repairable Android Virtual Device. 


X An Android Virtual Device that failed to load, Click ‘Details’ to see the error. 











Figura 7.2: AVD com Google APIs 


Para utilizar o serviço do Google Calendar, é necessário que o usuário possua 
uma conta do Google. Esta conta também precisa estar registrada no dispositivo 
para que possamos utilizá-la, tanto para autenticar o usuário como para solicitar 
acesso à sua agenda. 

Inicie o novo AVD criado com o add-on Google APIs. Com o emulador já ini- 
ciado, acesse o menu do dispositivo e selecione Configurações e em seguida a 
opção Contas e Sincronização. Escolha Adicionar nova contaesigaas 
instruções. Você pode utilizar a sua própria conta do Google ou criar uma especifi- 
camente para testes. 


7.2 ADICIONE BIBLIOTECAS AUXILIARES 


O Google, além de disponibilizar APIs para acessar remotamente os seus serviços, 
também disponibiliza um conjunto de bibliotecas para acessá-los em diversas lin- 
guagens de programação diferentes. Utilizaremos algumas delas para nos ajudar 
na autenticação do usuário e na integração com o Google Calendar. Acesse o site 
http://code.google.com/p/google-api-java-client/wiki/APIsgCalendar API e faça o 
download da última versão da biblioteca Calendar API. 

Ao fazer o download e descompactar o arquivo, além da própria Calendar API, 
também teremos as suas dependências, localizadas na pasta dependencies. Para 
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utilizar a Calendar API no Android precisamos adicionar os seguintes arquivos jar 
ao nosso projeto: 


* google-api-calendar-v3-rev7-java-1.6.0-beta.jar 
* google-api-client-1.X.X-beta.jar 

* google-api-client-android2-1.X.X-beta.jar 

* google-oauth-client-1.X.X-beta.jar 

* google-http-client-1.X.X-beta.jar 

* google-http-client-android2-1.X.X-beta.jar 

e gson-2.X.jar 

e guava-11.X.X.jar 

* jackson-core-asl-1.X.X.jar 

e jSr305-1.3.9.jar 


* protobuf-java-2.X.X jar 


No Eclipse, crie uma nova pasta no projeto com o nome de libs e copie para 
lá os arquivos listados acima. É essencial que o nome seja este, pois é lá que o plugin 
ADT irá procurar as bibliotecas utilizadas pelo aplicativo. A estrutura do projeto 
ficará conforme demostra a imagem 7.3. 
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© = BoaViagem 
> src 
P EB gen Generated java Tile 
P mi Google APIs [Android 2.3.3) 
b Ei Android Dependencies 
Es assets 
P És bin 
* libs 


&+ google-api-client-1.9.0-beta.jar 

5» google-api-client-android2-1.9,0-beta jar 

> google-api-services-=calendar-v3-rev7-1.6.0-beta.jar 
> google-http-client-1.9.0-beta.jar 


> google-http-client-android2-1.9.0-beta.jar 
5 google-oauth-client-1.9.0-betajar 
> gson-2.1 jar 
> quava-11.0.1.jar 
> jackson-core-asl-1.9.4.jar 
> jsr305-1.3.9.jar 
© protobuf-java-2.2.0.jar 
bres 

1 AndroidManifest.xml 

db proguard.cfg 

E project.properties 





Figura 7.3: Pasta lib do projeto 


7.3 ADICIONE AS PERMISSÕES NECESSÁRIAS 


É necessário adicionar algumas permissões no AndroidManifest .xml para que 
possamos acessar a Internet e recuperar as contas armazenadas no dispositivo. As 


permissões necessárias são as seguintes: 


<uses-permission android:name="android.permission. INTERNET" /> 
<uses-permission android:name="android.permission.USE CREDENTIALS" /> 
<uses-permission android:name="android.permission.GET ACCOUNTS" /> 
<uses-permission android:name="android.permission.MANAGE ACCOUNTS" /> 


7-4 REGISTRE A APLICAÇÃO NO GOOGLE 


Além das bibliotecas auxiliares, para realizar a integração com o Google Calendar 
precisaremos de mais duas coisas. A primeira é obter uma chave (API key) para 
identificar o nosso aplicativo junto ao Google. 

Também precisaremos criar um client ID, que será utilizado para que o usuário 
autorize o acesso aos dados da sua agenda. Esta autorização será realizada através do 
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protocolo OAuth 2.0, um protocolo para autorização e autenticação, utilizado por 
diversos serviços conhecidos, como o Twitter e Facebook. 

O registro da aplicação para a obtenção das chaves é feito através do Google 
Console. É necessário possuir uma conta do Google para realizar este procedimento. 
Faremos isto agora. 

Acesse o site https://code.google.com/apis/console/ e clique em Create 


Project. 


a 
r 
AAO | picoogie aris Console 


e C E https://code.google.com/apis/console/ wire @ WA 











Gmail Calendar Documents Photos Sites Groups Search More ¥ livrodeandroid@qmail.com ¥ | Settings ¥ | Help | Sign out 
Google apis 


Start using the Google APIs console 
to manage your API usage 


Creating an APIs project will let you 

« Use Google APIs beyond anonymous limits 
« Monitor AP! usage and control API access. 
* Share API management with a team. 


Create project... 


© 2011 Google - Code Home - Privacy Policy 





Figura 7.4: Google Console 


Na tela seguinte, ative a Calendar API clicando no botão off da coluna Status. 


205 


7.4. Registre a aplicação no Google Casa do Código 





e E @ Witps://code.goagie.com/apis/console/b/1/#proyect’SG1817101 235 services tea 
Gmail Calendar Documents Photos Sites Groves Search More v livredeandreig@egmail.com v | Settings v | Help | Sigo out 


Google apis 


API Project PO All (30) Actwe (1) Inactive (97) 





All services 
‘Select services for the project. 


Service Notes 

© Ad Exchange Buyar API = Courtesy umar 1,000 roquestsiday 

X AdSense Host API Courtesy limit: 100.000 requests/day 

SL AdSense Managemert API I Courtesy uma 10,000 requersts/ctay 

EB Analytics API Courtesy limit: 50,000 requestsicay 

Q aut API I Courtesy limit. 10,000 røquests/day 

© BigQuery API a Courtesy limit: 10,000 requests /day + Pricing 
D Blogger API Courtesy limit 10,000 requests tary 


© Books AP) ( Courtesy limit: 1,000 requests/day 


A custom Search API E - Courtesy limit: 100 requestsiday + Pricng 


X Drive API OFF | Courtesy limit. 500.000 requests/dey 
© Drive SOK 


© Freebase API 





Figura 7.5: Ativando o servico 


No menu localizado do lado esquerdo, selecione a opção API Access. Na parte 
inferior da página apresentada está listada a API key que utilizaremos para identificar 
nosso aplicativo no Google. A imagem 7.6 destaca a API key. 
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ano E Coogle Aris Console = i 
é CS hmps://code.google.com/apis/console/eprojecr 561817101115access ot mews 





Gmail Calendar Documents Photos Sites Groups Search More v livrodeandroisgamall.com v | Settings v | Help | Sign out 


Google apis 


API Project | 
API Access 
To prevent abuse Google places limits on API requests Using a valid OAuth token or API kay allows you to axcead anonymous limits by 
connecting requests back to your project 


Authorized API Access 


OAuth 2.0 allows users to shave specific: cats with you (lor example, 


isis) whia keeping their « 


treme privata A single projot! mary contain up to 7 cleri (Ds 


Create an OAuth 2.0 client ID... 


Lean more 


Simple API Access 
Use API keys to identify your project when you do not need to access user data. Learn more 
Gn rend trono Way 
Est Allows nieve 
Dunin hay 
Activated on: Jun 41, 2012 3:57 PM 
Activated by livrodeandroidGigmail com - you 


Create new Server key... | Create new Browser key... 





Figura 7.6: API Key 


Nesta mesma página também teremos uma opção para criar uma “OAuth 2.0 
client ID”. Ao selecionar esta opção, será necessário informar o nome do aplicativo 
que será apresentado ao usuário quando for solicitada autorização para acessar seus 
dados da agenda. Opcionalmente, podemos informar a URL da logo do produto. 

Ao selecionar a opção Next, devemos informar o tipo da aplicação. No nosso 
caso, a opção adequada éa Installed Application pois a nossa aplicação será 
instalada em um dispositivo. As imagens a seguir demonstram esses passos. 
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Create Client ID 


Branding Information 
The following information will be shown to users whenever you request access to their 
privato data using your new client ID. 


BoaViagem 


lvroseandroidgegmail.com - you 
Lank your propact to Mis account's profde and reputation. 


NELES! ej ap COTY HABITS Lg] 


„update | 


Max era 12G pivais 








Figura 7.7: Criando client ID 
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Create Client ID 


Client ID Settings 


Actemsed by wod brawnens over n rota, 
1.4 Service account 
Calis Gaogie: APIs on behalt of your applicating instead ef an ene acer Lour 
mare 
© Installed application 
Runs on s gesktop computer or hanangia device (like Android or IPhone). 


Create client 10 | Back | Cancel | 





Figura 7.8: Criando client ID 


E pronto, você já registrou sua aplicação no Google! 


7.5 AUTENTIQUE O USUÁRIO COM A CONTA DO GOOGLE 


Com o ambiente preparado, agora podemos iniciar a implementação das novas fun- 
cionalidades! Iniciaremos realizando a autenticação do usuário com base na sua 
conta do Google, registrada no dispositivo. Esta abordagem é interessante, pois evita 
que nosso aplicativo tenha que manter uma base própria de usuários além de trazer 
comodidade a eles já que podem utilizar os seus logins e senhas já existentes. 

Na classe BoaViagemActivity vamos substituir a autenticação existente e in- 
cluir esta nova implementação. A ideia é que o usuário forneça o login e senha de 
sua conta Google. A partir dessas informações, utilizaremos o AccountManager 
do Android e solicitaremos para que as credenciais sejam confirmadas. 

O AccountManager suporta vários tipos de conta, como contas do Facebook 
e Microsoft Exchange. No momento nos interessa apenas as contas do tipo Google 
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por isso utilizaremos a classe GoogleAccountManager que já traz facilidades para 
lidar com este tipo de conta. 

No método onCreate da BoaViagemActivity, vamos instanciar o 
GoogleAccountManager, passando o contexto como parâmetro. Também rea- 
lizamos algumas alterações no método onCreate, para utilizar um arquivo de pre- 











feréncias global para o aplicativo e movemos a constante MANTER CONECTADO para 





a classe de constantes. 


Incluímos um novo método iniciarDashboard que será utilizado também 
em outras partes do código: 


import static br.com.casadocodigo.boaviagem. Constantes. * 


// novos atributos 

private SharedPreferences preferencias; 
private GoogleAccountManager accountManager; 
private Account conta; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.login) ; 


accountManager = new GoogleAccountManager (this) ; 

usuario = (EditText) findViewById(R.id.usuario) ; 

senha = (EditText) findViewById(R.id.senha) ; 

manterConectado = (CheckBox) findViewById(R.id.manterConectado) ; 
preferencias = getSharedPreferences (PREFERENCIAS, MODE PRIVATE); 
boolean conectado = preferencias 


. getBoolean (MANTER. CONECTADO, false); 


if (conectado) { 
iniciarDashboard() ; 


private void iniciarDashboard(){ 
startActivity(new Intent(this, DashboardActivity.class)); 
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public class Constantes { 
// novas constantes 
public static final String PREFERENCIAS = "preferencias globais"; 
public static final String MANTER CONECTADO = "manter conectado"; 


Vamos alterar a implementação do método entrarOnClick, que agora passará 
a invocar o método autenticar. 


public void entrarOnClick(View v){ 
String usuarioInformado = usuario.getText().toString() ; 
String senhaInformada = senha.getText() .toString() ; 


autenticar (usuarioInformado, senhaInformada) ; 


No método autenticar, caso não seja possível localizar a conta, emitimos 
uma mensagem de aviso para o usuário. Para realizar a autenticação construímos 
um Bundle, informando as credenciais do usuário e solicitamos sua verificação 


invocando o método confirmCredentials do AccountManager. 


private void autenticar(final String nomeConta, String senha) { 
conta = accountManager .getAccountByName (nomeConta) ; 


if (conta == null){ 
Toast .makeText (this, R.string.conta_inexistente, 
Toast.LENGTH LONG) .show() ; 
return; 


Bundle bundle = new Bundle(); 
bundle.putString(AccountManager.KEY ACCOUNT NAME, nomeConta) ; 
bundle. putString (AccountManager .KEY_PASSWORD, senha); 


accountManager . getAccountManager () 
.confirmCredentials(conta , bundle, this, 
new AutenticacaoCallback(), null); 


Como parâmetro para o método confirmCredentials precisamos passar a 
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conta, o bundle com as credenciais, o contexto eum callback que será invocado 
quando a operação for realizada, além de um handler (nulo no nosso exemplo). 
O método confirmCredentials não retorna nada de imediato, ele será exe- 
cutado de forma assíncrona e quando a operação solicitada finalizar, o callback 
será invocado. É lá que verificaremos se a autenticação ocorreu com sucesso. 
Optamos por implementar este callback como uma classe privada, e temos 
que implementar a interface AccountManagerCallback: 


private class AutenticacaoCallback 
implements AccountManagerCallback<Bundle> 1 


@Override 
public void run(AccountManagerFuture<Bundle> future) { } 


Em seguida, obtemos o bundle que contém os resultados da operação de con- 
firmação de credenciais. 


private class AutenticacaoCallback 
implements AccountManagerCallback<Bundle> { 


@Override 
public void run(AccountManagerFuture<Bundle> future) { 
try { 


Bundle bundle = future.getResult() ; 


} catch (OperationCanceledException e) { 
// usuário cancelou a operação 

} catch (AuthenticatorException e) { 
// possivel falha no autenticador 

} catch (IOException e) { 
// possível falha de comunicação 


Em seguida, verificamos se a operação foi realizada com sucesso, ou seja, se o 
login e senha foram informados corretamente, avaliando se o conteúdo armazenado 
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nachave KEY BOOLEAN RESULT é verdadeiro. Em caso de falha, alertamos o usuá- 














rio, caso contrário, a dashboard do aplicativo é iniciada. 


private class AutenticacaoCallback 
implements AccountManagerCallback<Bundle> 1 


@Override 
public void run(AccountManagerFuture<Bundle> future) { 
try { 


Bundle bundle = future.getResult() ; 
if (bundle.getBoolean(AccountManager.KEY BOOLEAN RESULT)) { 


iniciarDashboard() ; 


} else { 
Toast .makeText (getBaseContext (), 
getString(R.string.erro_autenticacao), 
Toast .LENGTH_LONG) .show() ; 


} catch (OperationCanceledException e) { 
//usuário cancelou a operação 

} catch (AuthenticatorException e) { 
//possivel falha no autenticador 

} catch (IOException e) { 
//possível falha de comunicação 


} 
} 
} 
Pronto! Execute a aplicação e autentique-se com a mesma conta adicionada ao 
dispositivo! 


7-6 SOLICITE AUTORIZAÇÃO PARA O GOOGLE CALENDAR 


Para realizar a integração, vamos precisar de uma autorização concedida pelo usuá- 
rio, para que o nosso aplicativo possa acessar seus dados da agenda. 

Esta autorização será feita utilizando o protocolo OAuth 2.0 que tem sido am- 
plamente utilizado por serviços na web e que estabelece uma forma simples e segura 
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de autorizar o acesso a um dado recurso por um determinado aplicativo, não sendo 
necessário que ele tenha acesso às credenciais do usuário. 

Basicamente, os passos realizados para uma autorização via OAuth 2.0 são os 
seguintes: 


1) O aplicativo requer ao serviço desejado autorização para acessar determinado 
recurso; 


2) O serviço solicita o consentimento do usuário; 
3) Se autorizado, o serviço fornece um token de acesso para o aplicativo; 
4) O aplicativo utiliza este token para realizar as requisições. 


O client ID que criamos anteriormente será utilizado nos passos 1 e 2 para iden- 
tificar o nosso aplicativo. Como estamos utilizando as bibliotecas auxiliares disponi- 
bilizadas pelo Google, não precisaremos implementar todo esse procedimento. No 
aplicativo BoaViagem, aproveitaremos o momento do login para solicitar a autoriza- 
ção necessária para acessar a agenda do usuário. 

Quando fazemos o pedido de acesso, precisamos informar qual é o recurso 
desejado. No âmbito do OAuth, o que desejamos acessar é conhecido como “es- 
copo” que no nosso caso é o Google Calendar, identificado como oauth2 :https: 
//www.googleapis.com/auth/calendar . 

Precisaremos informar este escopo quando fizermos a solicitação de um token 
de acesso. Vamos incluir este valor na classe Constantes. Aproveite também para 
incluir mais duas constantes que se referem à sua API key e ao nome da aplicação 
utilizado no registro do Google Console. Veja a seguir a definição das novas cons- 
tantes: 


public class Constantes { 

// novas constantes 

public static final String TOKEN ACESSO = "token acesso"; 

public static final String NOME CONTA = "nome conta"; 

public static final String APP NAME = "BoaViagem"; 

public static final String AUTH TOKEN TYPE = 
"oauth2:https://www.googleapis.com/auth/calendar"; 

public static final String API KEY = 
"sua api key obtida no google console"; 


// constantes existentes 
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Assim como fizemos na autenticação, criaremos um novo método e 
um callback para tratar da autorização. Novamente utilizaremos o 
AccountManager, invocando o seu método getAuthToken para recuperar 
um token de acesso. Como parâmetro informaremos a conta e o escopo, além da 
activity e do callback que será invocado quando a operação terminar. Opcio- 
nalmente podemos informar também um bundle e um handler. O método 


solicitarAutorizacao terá o seguinte código: 


private void solicitarAutorizacao() 1 


accountManager.getAccountManager () 
. getAuthToken(conta, 
Constantes.AUTH TOKEN TYPE, 
null, 
this, 
new AutorizacaoCallback(), 
null); 


O AutorizacaoCallback será utilizado para tratar a resposta do pedido de 
autorização. O que precisaremos fazer é recuperar o token de acesso e o nome da 
conta e gravar essas informações nas preferências do aplicativo para utilizarmos pos- 


teriormente. 


private class AutorizacaoCallback 
implements AccountManagerCallback<Bundle> { 


@Override 
public void run(AccountManagerFuture<Bundle> future) { 


try { 
Bundle bundle = future.getResult() ; 
String nomeConta = 
bundle. getString (AccountManager . KEY_ACCOUNT_NAME) ; 
String tokenAcesso = 
bundle. getString (AccountManager . KEY_AUTHTOKEN) ; 


} catch (OperationCanceledException e) { 
// usuário cancelou a operação 

} catch (AuthenticatorException e) { 
// possível problema no autenticador 
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} catch (IOException e) { 
// possível problema de comunicação 


Em seguida gravamos essas informações nas preferências e iniciamos a Dashbo- 
ard do aplicativo. 


private class AutorizacaoCallback 
implements AccountManagerCallback<Bundle> 1 


@Override 
public void run(AccountManagerFuture<Bundle> future) { 


try { 
Bundle bundle = future. getResult() ; 
String nomeConta = 
bundle. getString (AccountManager . KEY_ACCOUNT_NAME) ; 
String tokenAcesso = 
bundle. getString (AccountManager . KEY_AUTHTOKEN) ; 


gravarTokenAcesso(nomeConta, tokenAcesso) ; 
iniciarDashboard() ; 


} catch (OperationCanceledException e) { 
// usuário cancelou a operação 

} catch (AuthenticatorException e) { 
// possivel falha no autenticador 

} catch (IOException e) { 
// possível falha de comunicação 


private void gravarTokenAcesso (String nomeConta, String tokenAcesso) { 
Editor editor = preferencias.edit(); 
editor.putString (NOME CONTA, nomeConta) ; 
editor.putString(TOKEN ACESSO, tokenAcesso) ; 
editor.commit(); 
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No AutenticacaoCallback, quando a autenticação é realizada com sucesso, 
em vez de iniciar a Dashboard, invocamos o método solicitarAutorizacao. 


private class AutenticacaoCallback 
implements AccountManagerCallback<Bundle> 1 
@Override 
public void run(AccountManagerFuture<Bundle> future) { 


try { 


Bundle bundle = future. getResult() ; 
if (bundle.getBoolean (AccountManager.KEY BOOLEAN RESULT)) { 


solicitarAutorizacao(); 


} else { 
Toast .makeText (getBaseContext (), 
getString(R.string.erro_autenticacao), 
Toast .LENGTH_LONG) .show() ; 


} catch (OperationCanceledException e) { 
// usuario cancelou a operação 
} catch (AuthenticatorException e) { 
// possivel problema no autenticador 
} catch (IOException e) { 
// possível problema de comunicação 


Com essas implementações finalizamos a parte de autorização para utilizar o 
Google Calendar! Agora quando você se autenticar no aplicativo, será perguntado se 
autoriza o acesso aos seus dados da agenda, como mostra a figura 7.9. Experimente! 
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O aplicativo a seguir ou outros 
aplicativos solicitam permissão para 
acessar a sua conta, agora e no 
futuro. 


e BoaViagem 


Deseja permitir essa solicitação? 





Permitir Negar 


Figura 7.9: Solicitação de autorização 


7-7 TRATE A EXPIRAÇÃO DO TOKEN DE ACESSO 


O token fornecido para acessar os serviços do Google geralmente expiram uma hora 
após a sua criação. No entanto, outros serviços tais como Twitter e Facebook que 
também possuem autorização via OAuth podem estipular um período de tempo 
diferente para a validade do token de acesso. Nossas aplicações precisam tratar da 
expiração dele, caso contrário teremos problemas de acesso não autorizado. 
Existem diversas estratégias para lidar com essa expiração, que variam de acordo 
com o cenário de uso e o tipo de aplicação (web, mobile etc.) que utiliza o token. 
Uma alternativa é monitorar o tempo de expiração e revalidar o token antes que 
o tempo se esgote. Existem dois métodos na classe Credential que podem nos 





ajudar nisso: 0 getExpirationTimeMilliseconds, que retorna a validade do 


218 


Casa do Código Capítulo 7. Utilize Google APIs e crie funcionalidades interessantes 








token em milissegundos eo getExpiresInSeconds () que devolve a quantidade 
de segundos que restam antes que ele expire. 

Na aplicação BoaViagem sempre obteremos um novo token quando o usuário 
acessar a aplicação. Para fazer isso, será necessário invalidar o token obtido anterior- 
mente do AccountManager. O token já conhecido será retornado, e pode já estar 
expirado. 

É importante frisar que obter um novo token não quer dizer que o usuário terá 
que autorizar o aplicativo novamente. O aplicativo continua autorizado. O usuário 
não notará que isso aconteceu. 

A invalidação do token e a recuperação de um novo serão realizadas no 
método solicitarAutorizacao. Para invalidá-lo, invocamos o método 
invalidateAuthToken do AccountManager. O código que solicita um novo 
token permanece o mesmo já apresentado. 

Ainda que o usuário tenha escolhido se manter conectado, ou seja, en- 
trar direto sem informar as credenciais, teremos que obter um token válido no- 
vamente. Portanto, alteramos o método onCreate para invocar o método 
solicitarAutorizacaoemvezde iniciarDashboard quando a opção “Man- 
ter conectado” foi marcada. Com isso, teremos o seguinte código: 


private void solicitarAutorizacao() 1 


String tokenAcesso = preferencias.getString(TOKEN ACESSO, null); 
String nomeConta = preferencias.getString (NOME CONTA, null); 


if(tokenAcesso != null){ 
accountManager .invalidateAuthToken(tokenAcesso) ; 
conta = accountManager . getAccountByName(nomeConta) ; 


accountManager .getAccountManager () 
.getAuthToken(conta, 
Constantes.AUTH TOKEN TYPE, 
null, 
this, 
new AutorizacaoCallback(), 
null); 


@Override 
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public void onCreate (Bundle savedInstanceState) { 
//códigos existentes 
if (conectado) { 
solicitarAutorizacao(); 


} 


Pronto! Agora a nossa aplicação está utilizando uma conta do Google para au- 
tenticar o usuário e mantê-lo conectado. 


7.8 CONHEÇA A CALENDAR API 


A Calendar API permite desenvolver aplicações que interagem com a agenda do 
usuário, sendo possível criar novos eventos, alterar e excluir os que já existem, além 
de permitir a realização de buscas. Também é possível criar e remover calendários. 
A Calendar API possui alguns conceitos básicos: 





* Event - é um evento de uma agenda (calendário) que possui informações tais 
como título, participantes e data de início e fim; 


e Calendar - representa uma única agenda do usuário. No Google Calendar é 
possível criar várias agendas, uma é considerada como a principal e é identi- 
ficada pelo nome da conta do Google. As demais agendas criadas são classifi- 
cadas como secundárias; 


e Calendar List -éa lista de calendários do usuário, contendo o principal e 
os secundários; 


e Setting - representa as preferências do usuário, como o seu fuso horário; 
* ACL - é uma regra de acesso (compartilhamento) do calendário; 
e Color - são as cores utilizadas para destacar os eventos e as agendas; 


* Free/busy - conjunto de períodos nos quais os calendários não possuem 


nenhum evento. 





Para cada conceito existe um recurso associado ( Event, Calendar e ou- 
tros). Os recursos são agrupados e disponibilizados pelo serviço através de coleções ( 





Events, Calendars, CalerdarList, Settingse ACL). Este modelo se reflete 
na biblioteca cliente que dispõe de classes para representar esses recursos e coleções. 
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A documentação completa da Calendar API está disponível em http://code. 
google.com/apis/calendar/v3/using.html. Veremos a seguir algumas formas de 
utilizá-la. 


7.9 ADICIONE EVENTOS NO GOOGLE CALENDAR 


A autenticação e autorização estão prontas e não corremos mais o risco de utilizar 
um token de acesso inválido. Além disso, já vimos um pouco do que é a Calendar 
API. 

Partiremos agora para a inclusão de um evento na agenda do usuário. Basica- 
mente o que precisaremos fazer é utilizar as classes disponibilizadas pela biblioteca 
cliente da Calendar API para criar os objetos necessários e invocar o método que 
realizará a inclusão dos dados na agenda. Toda a parte de comunicação HTTP, seri- 
alização dos dados e tratamento das respostas serão feitos pela biblioteca cliente. 

Para continuar mantendo nosso código organizado, vamos criar 
uma nova classe para tomar conta dessa integração com o Go- 
ogle Calendar. Crie a classe CalendarService no pacote 
br.com.casadocodigo.boaviagem. calendar. De antemão, precisare- 
mos do nome da conta e do token de acesso que serão utilizados, vamos recebê-los 


no construtor da classe: 


public class CalendarService { 


private Calendar calendar; 
private String nomeConta; 


public CalendarService(String nomeConta, String tokenAcesso) { 
this.nomeConta = nomeConta; 
GoogleCredential credencial = new GoogleCredential() ; 
credencial.setAccessToken(tokenAcesso) ; 


O nome da conta sera utilizado posteriormente para identificar qual calendario 
será utilizado, lembrando que este será o calendário principal do usuário. Criamos 
também uma nova credencial do aplicativo e atribuímos a ela o token de acesso. Esta 
credencial será utilizada durante as requisições para o serviço. 

A classe Calendar do pacote com.google.api.services.calendar re- 
presenta o serviço propriamente dito e através dela conseguiremos manipular os 
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eventos. Sua instanciação é feita através deum builder que depende de dois outros 
objetos que fazem parte da Google API Client Library, que são o HttpTransport, 
para a comunicação HTTP e do JsonFactory, para serialização dos objetos. Além 
disso, devemos atribuir à nossa API key a credencial e o nome do aplicativo. Tudo 
isso realizado ainda no construtor: 


public CalendarService(String nomeConta, String tokenAcesso) { 
this.nomeConta = nomeConta; 
GoogleCredential credencial = new GoogleCredential() ; 
credencial.setAccessToken(tokenAcesso) ; 


HttpTransport transport = AndroidHttp.newCompatibleTransport () ; 
JsonFactory jsonFactory = new GsonFactory(); 


calendar = Calendar.builder(transport, jsonFactory) 
.setApplicationName (Constantes.APP NAME) 
. setHttpRequestInitializer(credencial) 
. set JsonHttpRequestInitializer ( 
new GoogleKeyInitializer (Constantes.API_KEY) ) 
«build O; 


A ideia é que um evento seja criado a partir das informações de uma viagem. 
Então criaremos um método no CalendarService que recebe uma viagem, cha- 





mado criarEvento: 


public String criarEvento (Viagem viagem) { } 





Criaremos um novo Event e colocamos a sua descrição como sendo o destino 
da viagem. É obrigatório informar uma lista de participantes identificados através 


do e-mail. No nosso caso, o participante é o próprio usuário, então informamos o 





nome da conta (que é um e-mail do Google) e incluímos no Event. Em seguida 
criamos as datas de início e fim do evento baseados no período da viagem, incluindo 
as informações de fuso horário, obrigatórios para o Calendar. 


public String criarEvento (Viagem viagem) { 
Event evento = new Event (); 
evento. setSummary (viagem.getDestino()); 


List<EventAttendee> participantes = 
Arrays.asList ((new EventAttendee() .setEmail (nomeConta))) ; 


222 


Casa do Código Capítulo 7. Utilize Google APIs e crie funcionalidades interessantes 





evento. setAttendees(participantes); 


DateTime inicio = new DateTime(viagem.getDataChegada(), 


TimeZone.getDefault ()); 


DateTime fim = new DateTime(viagem.getDataSaida(), 


TimeZone.getDefault ()); 


evento.setStart (new EventDateTime().setDateTime(inicio)); 


evento. setEnd (new EventDateTime().setDateTime(fim)); 


Invocamos o método de acesso à coleção events e nela inserimos o novo evento 


especificando o calendário através do nome da conta. Para de fato realizar a requisi- 


ção para o serviço devemos invocar o método execute. 





Em caso de sucesso, este método retorna um Event que possui um identifica- 


dor único que utilizamos como valor de retorno. Devemos utilizar esse identificador 


posteriormente se quisermos editar 
sição remota é possível que uma IO! 
a exceção. 


ou remover o evento. Por se tratar de uma requi- 





Exception seja lançada e neste caso relançamos 


public String criarEvento (Viagem viagem) { 


Event evento = new Event(); 


evento.setSummary (viagem.getDestino()); 


List<EventAttendee> participantes = 


Arrays.asList ((new EventAttendee() .setEmail (nomeConta))); 


evento.setAttendees (participantes); 


DateTime inicio = new DateTime(viagem.getDataChegada(), 


TimeZone. getDefault()); 


DateTime fim = new DateTime (viagem. getDataSaida(), 


TimeZone. getDefault()); 


evento.setStart(new EventDateTime() .setDateTime (inicio) ); 


evento.setEnd(new EventDateTime() .setDateTime(fim)) ; 


223 


7.9. Adicione eventos no Google Calendar Casa do Código 





try { 
Event eventoCriado = calendar .events() 
. insert (nomeConta, evento) 
.execute(); 
return eventoCriado.getId(); 
} catch (IOException e) { 
throw new RuntimeException(e) ; 


Já estamos quase lá. Só falta alterar a ViagemActivity para utilizar o 
CalendarService e teremos a inclusão de eventos na agenda do usuário con- 
cluída. 

No método onCreate da  ViagemActivity instanciaremos um 
CalendarService recuperando o nome da conta e o token de acesso das 


preferências do aplicativo: 


// novo atributo 
private CalendarService calendarService; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
//codigos existentes 
calendarService = criarCalendarService(); 
} 
private CalendarService criarCalendarService() { 
SharedPreferences preferencias = 
getSharedPreferences (PREFERENCIAS, MODE PRIVATE); 
String nomeConta = preferencias.getString (NOME CONTA, null); 
String tokenAcesso = preferencias.getString(TOKEN ACESSO, null); 


return new CalendarService (nomeConta, tokenAcesso) ; 


Como inserir um novo evento na agenda do usuário é uma operação demorada, 
pois envolve acesso à rede, implementaremos uma AsyncTask, para executar essa 
operação em segundo plano. No capítulo 6 já aprendemos como fazê-lo. 

No método salvarViagem, logo após a gravação no banco de dados, executa- 
remos uma AsyncTask para inserir o evento na agenda do usuário: 


public void salvarViagem(View view){ 
// códigos existentes 
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if(id == 1) { 
resultado = dao. inserir (viagem); 
new Task() .execute(viagem) ; 
} else { 
resultado = dao.atualizar(viagem) ; 
} 


// cédigos existentes 


private class Task extends AsyncTask<Viagem, Void, Void> { 
@Override 
protected Void doInBackground(Viagem... viagens) { 
Viagem viagem = viagens[0]; 
calendarService.criarEvento(viagem) ; 
return null; 


Sem mais delongas, inicie o aplicativo, cadastre uma nova viagem e confira o 
evento criado na sua agenda do Google Calendar! Para realizar as operações de atu- 
alização e remoção de eventos do Google Calendar é necessário referenciar o id 
do evento desejado que é retornado quando o mesmo é criado. A partir dele pode- 
riamos implementar os métodos de remoção e atualização no CalendarService 
invocando a API cliente da seguinte forma: 


// para remover 
calendar .events() .delete (nomeConta, "eventId') .execute(); 


// para atualizar 
service.events() .update(nomeConta, "eventId", eventoAtualizado) 
.execute(); 


7.10 CONCLUSÃO 


Neste capítulo realizamos uma integração para incluir um novo evento na agenda 
do usuário no Google Calendar quando uma nova viagem for criada no aplicativo 
BoaViagem. 

Utilizamos também uma conta registrada no dispositivo para realizar a auten- 
ticação dos usuários. Aprendemos um pouco sobre o protocolo OAuth 2.0 e como 
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aproveitar a Google Client Library para realizar a autorização de um aplicativo e 
também efetuar as chamadas remotas ao serviço Google Calendar. 

O conhecimento adquirido neste capítulo pode ser aplicado para o uso de qual- 
quer outra API do Google, aproveite-as! 
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CAPÍTULO 8 


Explore os recursos de hardware 


Uma das características que tornam a plataforma Android amigável ao desenvolve- 
dor é a existência de APIs para facilitar a manipulação dos recursos de hardware. 
Quando bem utilizados, eles incrementam as funcionalidades das aplicações e me- 
lhoram a experiência do usuário. 

Neste capítulo veremos como utilizar a câmera do dispositivo para capturar e exi- 
bir imagens e vídeos. Através do MediaPlayer faremos a reprodução de músicas e 
vídeos além de implementar um exemplo utilizando o GPS para obter a localização 
do aparelho e exibi-la em um mapa. 

Para começar, crie um novo projeto Android, para testar os códigos 
apresentados. Chame-o de Hardware para o projeto e utilize o pacote 
br.com.casadocodigo.hardware. Nas seções seguintes veremos códigos para 
trabalhar com alguns dos recursos de hardware disponíveis. É recomendado utilizar 
um aparelho Android em vez do emulador pois desta forma será mais rápido e mais 
fácil de verificar o resultado das implementações. 
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8.1 CAPTURE FOTOS COM SEU APARELHO 


Um dos recursos que mais se popularizou entre os telefones celulares, antes mesmo 
da existência dos smartphones, foi a câmera fotográfica embutida no dispositivo. 
Como uma imagem publicada em uma rede social vale mais do que 140 caracte- 
res, aplicativos como Instagram, Skitch e vários outros exploram este recurso para 
criar novas formas de interação. 

O objetivo nesta seção é conhecer como utilizar a câmera do dispositivo em um 
aplicativo Android. Em nosso exemplo, iremos requisitar ao próprio aplicativo da 
câmera para que a foto seja capturada utilizando uma Intent. Esta é uma forma 
simples e prática de incluir essa funcionalidade no seu aplicativo. 

As imagens capturadas devem ser armazenadas no cartão de memória para evitar 
que o espaço de armazenamento interno, que é mais limitado e utilizado pelo sistema 
operacional, não seja comprometido. Além disso, o usuário pode retirar o cartão do 
dispositivo e utilizar o seu computador para recuperar as fotos facilmente. 


Por padrão, existem dois diretórios que podemos utilizar para salvar as 





imagens capturadas. O getExternalStoragePublicDirectory, da classe 





Environment, que retorna um diretório compartilhado por todas as aplicações, é 
o recomendado para o armazenamento de fotos e vídeos. Como ele não está asso- 
ciado ao aplicativo que gravou a imagem, quando este é desinstalado, os dados não 
são perdidos. 


O outro diretório que pode ser utilizado é o obtido através de 





Context .getExternalFilesDir, que retorna um diretório associado ao 
aplicativo. As imagens salvas nele são removidas quando o aplicativo é desins- 
talado. A escolha de qual utilizar depende do propósito do aplicativo e de qual 
comportamento é o mais adequado em caso de desinstalação. 

Para iniciar os testes com a câmera, crie uma nova activity com o nome de 
CameraActivity. Nela implementaremos as funcionalidades de captura e visu- 
alização da imagem. O layout desta activity (câmera. xm1) terá dois botões para 
disparar as funcionalidades citadas: 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="Vertical" > 


<Button 
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android: layout width="match parent" 
android:layout height="wrap content" 
android: text="@string/capturar_imagem" 
android: onClick="capturarImagem"/> 


<Button 
android: layout_width="match_parent" 
android:layout height="wrap content" 


android:text="Ostring/visualizar imagem" 


android:onClick="visualizarImagem"/> 
</LinearLayout> 


Na CameraActivity faremos a chamada ao aplicativo da câmera através de 
uma Intent. No entanto, precisaremos obter uma resposta deste aplicativo para 
saber se a captura foi bem sucedida ou não. Nessas situações podemos iniciar uma 
atividade utilizando o método startActivityForResult. Quando a operação 
solicitada for finalizada, o método onActivityResult, da atividade que fez a so- 
licitação, é invocado. O código inicial da CameraActivity é o seguinte: 


public class CameraActivity extends Activity { 
private static final int CAPTURAR IMAGEM = 1; 
private Uri uri; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.camera) ; 


@Override 
protected void onActivityResult (int requestCode, 
int resultCode, Intent data) 1 


public void capturarImagem(View v){ 


} 


public void visualizarImagem(View v){ 


} 
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Para realizar a captura da imagem, precisaremos criar uma Intent e passar 
como extra a Uri informando o nome e local de armazenamento da imagem. Uti- 
lizaremos o diretório público, que é o recomendado. 

Recuperamos o diretório e o escolhemos para armazenar nossas imagens. Em 
seguida geramos o nome da imagem com base no diretório obtido utilizando a in- 
formação de tempo do sistema em milissegundos para termos um nome único. A 
extensão do arquivo é definida como . jpg. Em seguida, recuperamos o objeto Uri 
com o caminho: 


public void capturarImagem(View v) 1 
File diretorio = Environment 
. getExternalStoragePublicDirectory( 
Environment .DIRECTORY PICTURES) ; 


String nomeImagem = diretorio.getPath() + "/" + 
System.currentTimeMillis() + 


"n E jpg" ; 
uri = Uri.fromFile(new File (nomeImagem)); 
Precisamos definir a Intent e utilizá-la para iniciar uma nova atividade que 


deve retornar um resultado. Para o método startActivityForResult é ne- 
cessário informar um código para identificar a solicitação. Utilizamos a constante 





CAPTURAR IMAGEM com esta finalidade. Isso é necessário, pois podemos iniciar 
várias atividades distintas que devem retornar resultados. No nosso exemplo, mais 
adiante utilizaremos o método startActivityForResult com uma Intent 
para capturar vídeos. 


public void capturarImagem(View v) 1 
// Recupera o arquivo e a URI 


Intent intent = new Intent (MediaStore.ACTION IMAGE CAPTURE) ; 
intent.putExtra(MediaStore.EXTRA OUTPUT, uri); 


startActivityForResult (intent, CAPTURAR IMAGEM) ; 
Quando o aplicativo da câmera tirar a foto e o usuário confirmar a captura, a ac- 
tivity da câmera será finalizada com um resultado eo método onActivityResult 
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da CameraActivity será invocado. Neste método, faremos uma checa- 
gem para saber se o resultado é para a solicitação que foi feita com o código 
CAPTURAR IMAGEM. 





Em seguida, avaliaremos se o resultado informado pela câmera se refere ao su- 
cesso ou falha na captura da imagem. Em caso de sucesso, a imagem deve ser adici- 
onada à galeria de fotos do Android. A implementação do onActivityResult é 
a seguinte: 


@Override 
protected void onActivityResult (int requestCode, 
int resultCode, Intent data) { 
if (requestCode == CAPTURAR. IMAGEM) { 
if (resultCode == RESULT OK) { 
mostrarMensagem(" Imagem capturada!") ; 
adicionarNaGaleria(); 
} else { 
mostrarMensagem("Imagem não capturada!"); 


} 
private void mostrarMensagem(String msg) { 
Toast.makeText (this, msg, 
Toast . LENGTH_LONG) 
.show(); 


Por mais que tenhamos armazenado a imagem em um diretório compartilhado e 
acessível pela galeria de fotos do Android, ela não é adicionada lá automaticamente. 
É necessário que façamos a sua inclusão. Para isso, basta disparar um broadcast 
para notificar que a foto deve ser incluída na galeria utilizando a Uri da imagem. O 
código para realizar esta operação é o seguinte: 


private void adicionarNaGaleria() { 
Intent intent = new Intent ( 
Intent.ACTION MEDIA SCANNER SCAN FILE); 
intent.setData(uri); 
this.sendBroadcast (intent) ; 


Para exibir a imagem capturada, utilizaremos uma Intent para invocar a gale- 
ria de imagens do Android. No método visualizarImagem passaremos a Uri e 
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o MIME type da imagem na Intent para iniciar a activity. Veja como fica o código: 


public void visualizarImagem(View v){ 
Intent intent = new Intent(Intent.ACTION_VIEW) ; 
intent.setDataAndType(uri, "image/jpeg") ; 
startActivity (intent) ; 


Com isto temos as funcionalidades de capturar e visualizar imagens utilizando 
Intents prontas! Para iniciar a CameraActivity, altereo main.xml para in- 
cluir um botão que irá disparar essa opção. 


<?aml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android: layout height="fill parent" 
android:orientation="vertical" > 


<Button 
android: id="@+id/camera" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: onClick="escolher0pcao" 
android: text="@string/testar_camera" /> 


</LinearLayout> 


Na HardwareActivity implemente o método escolherOpcao conforme o 
código a seguir, para abrir a Intent para a câmera. 


public void escolher0pcao (View view) { 
if(view.getId() == R.id.camera){ 
Intent intent = new Intent(this, CameraActivity.class) ; 
startActivity (intent); 


Pronto, agora é só executar a aplicação e testar a captura de fotos! 

Nas situações em que a câmera é essencial para o funcionamento do aplicativo 
podemos incluir essa obrigatoriedade no AndroidManifest.xml. Dessa forma, 
dispositivos que não possuem câmera não poderão instalar o aplicativo. Também é 
possível informar que o aplicativo utiliza a câmera mas que ela não é obrigatória. 


232 


Casa do Código Capítulo 8. Explore os recursos de hardware 





Para checar a existência da câmera em tempo de execução podemos fazer o se- 
guinte: 


public void capturarImagem(View v){ 
boolean temCamera = getPackageManager () 
.hasSystemFeature (PackageManager . FEATURE_CAMERA) ; 
if (temCamera) { 
//códigos implementados para a captura de imagens 


A seguir, veja a forma de declarar o uso da câmera no manifesto como requisito 
para a aplicação. Repare que, como não estamos utilizando diretamente o hardware 
da câmera, não é necessário adicionar nenhuma permissão. 


<!-- Câmera é obrigatória --> 

<uses-feature android:name="android.hardware.camera"/> 

<!-- Câmera não é obrigatória --> 

<uses-feature android:name="android.hardware.camera" 
android:required="false"/> 


8.2 GRAVE VÍDEOS 


Outro recurso que podemos explorar em nossos aplicativos é a gravação de vídeos. 
Também é possível utilizar Intent para requisitar a gravação de vídeos para a ca- 
mera do dispositivo assim como é feito para a captura de imagens. 

Além da possibilidade de informar onde o vídeo deve ser armazenado, podemos 
incluir outras informações extras na Intent para configurar a captura do vídeo: 





e MediaStore.EXTRA DURATION LIMIT - configura a duração limite da 
captura de vídeo em segundos. 














e MediaStore. EXTRA VIDEO QUALITY - determina em qual qualidade o ví- 
deo deve ser capturado. Para vídeos em baixa qualidade devemos informar o 
valor 0 e para os videos em alta qualidade, o valor 1. 


T 








e MediaStore.EXTRA SIZE LIMIT - define o tamanho limite em bytes para 
o vídeo que está sendo capturado. 
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Para testar a gravação de vídeos, na CameraActivity criaremos um 
novo método que utilizará o aplicativo da câmera para gravar em alta qua- 
lidade, com duração de 5 segundos. Não informaremos nada para o extra 





MediaStore.EXTRA OUTPUT, o que fará com que o vídeo gravado seja armaze- 
nado no diretório padrão e com um nome gerado automaticamente. Veja o código 
para iniciar a Intent: 


// nova constante para identificar a requisição 
private static final int CAPTURAR VIDEO = 2; 


public void capturarVideo(View v){ 
Intent intent = new Intent (MediaStore.ACTION VIDEO. CAPTURE) ; 
intent.putExtra(MediaStore.EXTRA VIDEO QUALITY, 1); 
intent.putExtra(MediaStore.EXTRA DURATION LIMIT, 5); 
startActivityForResult (intent, CAPTURAR VIDEO); 


No método onStartActivity teremos que verificar se o resultado obtido se 
refere à captura de vídeo e iremos utilizar a Intent recebida como parâmetro para 
saber o nome do arquivo e o local onde o vídeo foi armazenado. Veja: 


@Override 
protected void onActivityResult (int requestCode, 
int resultCode, Intent data) 1 
if (requestCode == CAPTURAR. IMAGEM) { 
if (resultCode == RESULT. OK) { 
mostrarMensagem("Imagem capturada!"); 
adicionarNaGaleria(); 
} else { 
mostrarMensagem("Imagem não capturada!"); 
} 
} else if(requestCode == CAPTURAR VIDEO) { 
if (resultCode == RESULT. OK) { 
String msg = "Vídeo gravado em " + 
data.getDataString(); 
mostrarMensagem(msg) ; 
uri = data.getData(); 
} else { 
mostrarMensagem("Vídeo não gravado"); 


234 


Casa do Código Capítulo 8. Explore os recursos de hardware 





Para exibir o vídeo, criaremos uma Intent utilizando a Uri recuperada de 
Intent .getData () que representa o arquivo que desejamos visualizar: 


public void visualizarVideo(View v){ 
Intent intent = new Intent (Intent.ACTION VIEW); 
intent.setDataAndType(uri, 'video/mp4"); 
startActivity(intent); 


Para testar essas novas funcionalidades, acrescente em camera.xml dois 
Buttons para chamar os métodos de capturar e visualizar o vídeo. 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout ... > 
<!-- botoes existentes -- > 
<Button 


android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: onClick="capturarVideo" 

android: text="@string/capturar_video" /> 


<Button 
android: layout_width="match_parent" 
android: layout height="wrap content" 
android:onClick="visualizarVideo" 
android:text="0Ostring/visualizar video" /> 


</LinearLayout> 


8.3 EXECUTE VÍDEOS E MÚSICAS 


Nesta seção iremos implementar algumas formas de executar vídeos e músicas em 
uma aplicação Android, utilizando basicamente a classe MediaPlayer e uma 
VideoView para exibir os vídeos. Comece criando uma nova atividade com o nome 
de MediaPlayerActivity e um arquivo de layout media player.xm1, que 
contará com alguns botões para acionar as diferentes formas de execução de músi- 
cas e de vídeo que iremos implementar, e também para controlar a sua execução. A 
definição será a seguinte: 
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<?xml version="1.0" encoding="utf-8"?> 

<TableLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android:layout height="match parent" > 


<Button 
android: layout width="wrap content" 
android:layout height="wrap content" 
android: onClick="executarMusicaArquivo" 
android: text="@string/executar_musica_arquivo" /> 


<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:onClick="executarMusicaUrl" 
android: text="@string/executar_musica_url" /> 


<Button 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:onClick="executarVideo" 
android: text="@string/executar_video" /> 


<TableRow> 


<Button 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android:onClick="parar" 
android:text="Ostring/parar" /> 


<Button 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:onClick="executar" 
android: text="@string/executar" /> 


<Button 
android: layout_width="wrap_content" 
android:layout height="wrap content" 
android: onClick="pausar" 
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android:text="Ostring/pausar" /> 
</TableRow> 


</TableLayout> 


O primeiro exemplo consiste em executar um arquivo .mp3 existente dentro da 
aplicação. Escolha uma das suas músicas preferidas e a inclua na pasta res/raw 
do projeto (crie a pasta raw se necessário). É importante que o nome do arquivo 
não contenha caracteres especiais, por isso, neste exemplo utilizaremos um arquivo 
chamado musica.mp3. 

Na classe MediaPlayerActivity criaremos um novo MediaPlayer, carre- 
gando este arquivo de música. Em seguida utilizaremos os métodos disponíveis no 
MediaPlayer para controlar sua execução. 


Veja o código a seguir: 
public class MediaPlayerActivity extends Activity 
private MediaPlayer player; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.media player); 


public void executarMusicaArquivo(View v) 1 
player = MediaPlayer.create(this, R.raw.musica); 
player.start(); 


Utilizamos o método utilitário MediaPlayer.create passando o contexto 
e o identificador do arquivo de música para criar um novo MediaPlayer. Para 
iniciar a execução invocamos o método start. No método create o arquivo foi 
carregado eo MediaPlayer preparado para a execução. Os controles serão feitos 
utilizando os métodos respectivos presentes no MediaPlayer: 


public void executar(View v) 1 


if(!player.isPlaying()) { 
player.start(); 
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public void pausar(View v) { 
if (player.isPlaying()) { 
player .pause() ; 


public void parar(View v) { 
if (player.isPlaying()) { 
player.stop(); 


O método start pode ser utilizado tanto para iniciar a execução pela pri- 
meira vez, como para retomar quando esta estiver em pausa. No entanto, se a re- 
produção for interrompida com o stop, só é possível iniciá-la novamente após o 
MediaPlayer ser preparado, ou seja, o método prepare deve ser invocado. 

Outra questão importante é que devemos sempre liberar o MediaPlayer 
quando o mesmo não for mais necessário. Isto contribuirá para a liberação da me- 
mória e também dos codecs utilizados. 

Podemos sobrescrever o método onStop da MediaPlayerActivity para 
tratar desta questão: 


@Override 

protected void onStop() { 
super.onStop() ; 
liberarPlayer () ; 

} 

private void liberarPlayer() { 
if (player != null){ 

player.release(); 


No próximo exemplo, em vez de carregar um arquivo .mp3 existente na apli- 
cação, faremos o seu carregamento a partir de uma URL. Este cenário requer uma 
atenção especial pois envolve acesso à Internet, o que pode tornar a operação demo- 
rada. 
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Já vimos que nestes casos devemos realizar a operação de forma assíncrona para 
não bloquear a UI e como esta é uma situação recorrente, o MediaPlayer já dis- 
ponibiliza um método de preparação assíncrona. 





Precisamos implementar a interface OnPreparedListener, que possui um 
método chamado onPrepared, que será invocado no término da preparação as- 
síncrona. Neste método, apenas chamaremos o start para iniciar a reprodução. 
No método executarMusicaUrl liberamos a instância anterior do player, que 
pode ter sido criada para executar um arquivo da aplicação, e criamos um novo 
MediaPlayer. 


public class MediaPlayerActivity extends Activity 
implements OnPreparedListener { 


//códigos existentes 


public void executarMusicaUrl(View v) 1 


liberarPlayer(); 

player = new MediaPlayer(); 
} 
@Override 


public void onPrepared(MediaPlayer mp) { 
player.start(); 


Agora, precisamos criar uma Uri a partir de uma URL qualquer, que refe- 
rencia o arquivo .mp3 desejado. Em seguida a atribuímos como datasource do 
MediaPlayer, além de informar que ela deverá ser executada. Por fim, atribuímos 
a própria activity como o listener da preparação assíncrona que é invocada. 


public class MediaPlayerActivity extends Activity 
implements OnPreparedListener ( 


//códigos existentes 
public void executarMusicaUrl(View v) 1 
liberarPlayer(); 


player = new MediaPlayer(); 
try d 
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Uri uri = Uri.parse("http://<alguma-url>/musica.mp3") ; 
player.setDataSource(this, uri); 
player .setAudioStreamType (AudioManager .STREAM_MUSIC) ; 
player.setOnPreparedListener (this); 
player .prepareAsync() ; 

} catch (Exception e) { 
throw new RuntimeException(e) ; 


@Override 
public void onPrepared(MediaPlayer mp) { 
player.start(); 


Com isto, temos a reprodução de músicas da Internet e também aquelas exis- 
tentes no aplicativo implementadas! Antes de testar, inclua a permissão de acesso à 


Internet no AndroidManifest.xml: 


<uses-permission android:name="android.permission. INTERNET" /> 





FORMATOS SUPORTADOS 


O Android suporta diversos formatos de áudio e vídeo, dentre eles 
arquivos .mp3, .mp4e .3gp. Para uma relação completa dos forma- 
tos suportados consulte http://developer.android.com/guide/appendix/ 
media-formats.html. 











Agora precisamos exibir um vídeo armazenado no aplicativo. Inclua na pasta 
res/raw um arquivo de vídeo com um dos formatos suportados. Utilizaremos um 
arquivo com nome de video.mp4. Ao contrário da reprodução de um arquivo 
de música em que manipulamos o MediaPlayer diretamente, agora iremos uti- 
lizar uma view que além de realizar a exibição do vídeo propriamente dito, tam- 
bém oferece os controles de execução. No arquivo media player .xml inclua uma 


VideoView: 


<TableLayout ...> 
<!-- códigos existentes --> 
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<VideoView android:id="@Qtid/videoView" /> 
</TableLayout> 


No método onCreate da MediaPlayerActivity obteremos uma re- 
ferência para a VideoView e utilizá-la-emos na implementação do método 
executarVideo. Basicamente, o que faremos é criar uma Uri para o vídeo ar- 
mazenado no dispositivo, atribuí-la para a VideoView, adicionar os controles de 
execução que são implementados pela classe MediaCont roller e por fim, iniciar 
a reprodução invocando o método VideoView.start. 


public class MediaPlayerActivity extends Activity 
implements OnPreparedListener{ 


private MediaPlayer player; 
private VideoView videoView; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.media player); 
videoView = (VideoView) findViewById(R.id.videoView); 


public void executarVideo(View v) { 
Uri uri = Uri.parse("android.resource://"+ getPackageName() + 
"/" + R.raw.video); 


videoView.setVideoURI (uri); 

MediaController mc = new MediaController(this); 
videoView.setMediaController (mc) ; 
videoView.start(); 


A Uri informada para a VideoView pode se referir tanto a um arquivo local 
como a um arquivo remoto. A VideoView já trata a preparação assíncrona do player 
e também já o libera quando não está mais em uso. Para abrir esta nova activity, 
acrescente um botão em main. xml eimplemente os códigos necessários no método 


escolherOpcao da HardwareActivity: 


<!-- main.xml --> 
<?xml version="1.0" encoding="utf-8"?> 
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<LinearLayout...> 
<!-- botoes existentes --> 
<Button 
android: id="@+id/mediaplayer" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: onClick="escolher0pcao" 
android:text="QOstring/testar media player" /> 
</LinearLayout> 


public void escolher0pcao (View view) { 
if(view.getId() == R.id.mediaplayer) { 
Intent intent = new Intent(this, MediaPlayerActivity.class) ; 
startActivity (intent); 


Execute a aplicação e experimente a reprodução de vídeos. 


8.4 DETERMINE A LOCALIZAÇÃO ATRAVÉS DO GPS E DA 
REDE 


Grande parte dos smartphones e tablets Android disponíveis no mercado contam 
com um sistema de posicionamento global, o GPS. Através dele é possível deter- 
minar a localização do dispositivo com boa precisão. No entanto, para funcionar 
adequadamente é necessário que o dispositivo esteja em um ambiente aberto para 
facilitar a comunicação com os satélites. 

O processo de localizar e conectar aos satélites pode ser demorado, o que au- 
menta o tempo de espera por informações de localização. 

Outra forma de se obter a localização é através do Network Location Provider 
que utiliza os sinais da rede de celular e WI-FI para determinar a localização do 
usuário. Apesar de ser menos precisa, esta forma consome menos bateria e obtém 
resultados de localização com mais rapidez, além de funcionar tanto em ambientes 
abertos como em recintos fechados. 

A partir dessas informações de localização, podemos, por exemplo, desenvol- 
ver um aplicativo que apresenta em um mapa os pontos de interesse próximos ao 
usuário, como supermercados, farmácias etc. A localização do usuário passa a ser 


relevante. 
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Vamos utilizar o GPS e a rede para obter as coordenadas de latitude e longitude 
e apresentar esta localização em um mapa do Google. Continuaremos utilizando o 
mesmo projeto Hardware. 

Para acessar informações de localização a plataforma Android disponi- 
biliza o LocationManager. Através dessa classe podemos registrar um 
LocatitonListener para receber as atualizações de localização, tanto de um 
GPS. PROVIDER como de um NETWORK PROVIDER. Além de receber dados de lo- 











calização, o listener é notificado quando algum provedor é habilitado ou desa- 
bilitado pelo usuário e também quando o provedor muda de estado (fora de serviço, 
disponível, temporariamente indisponível ou outro). 

Conforme o provedor de localização (GPS, rede ou ambos) que o 
aplicativo irá utilizar, é necessário declarar as permissões adequadas no 
AndroidManifest.xml. Quando o aplicativo utilizar apenas o provedor de 
rede, então a permissão que deve ser declarada é a seguinte: 


<uses-permission 
android:name="android. permission. ACCESS COARSE LOCATION" /> 


Já no caso onde o GPS será utilizado, a permissão necessária é a seguinte: 


<uses-permission 
android:name="android.permission.ACCESS. FINE LOCATION" /> 


Caso o aplicativo utilize os dois provedores de localização, então basta declarar 











a permissão android.permission.ACCESS FINE LOCATION, que além de au- 
torizar o uso do GPS, também permite a utilização do Network Location Provider. 
Inclua esta permissão no manifesto do projeto. 

Para iniciar a implementação, crie uma nova classe com o nome de 
LocalizacaoActivity e um novo arquivo de layout para ela com o nome de 





localizacao.xml. Inicialmente, nesta tela apresentaremos as coordenadas de la- 
titude e longitude, bem com o provider responsável por essas informações. Veja a 
definição do layout: 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout width="match parent" 
android: layout height="match parent" 
android:orientation="vertical" > 
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<TextView android:id="0+id/provedor" 
android: layout width="wrap content" 
android:layout height="wrap content" /> 


<TextView android: id="0+id/latitude" 
android: layout width="wrap content" 
android:layout height="wrap content" /> 


<TextView android: id="0+id/longitude" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 
</LinearLayout> 


Na LocalizacaoActivity registraremos um listener para receber as atu- 
alizações de localização e exibiremos essas informações nos TextViews. 

Precisaremos obter o LocationManager, que é responsável por gerenciar 
os provedores de localização. Depois, declaramos o nosso listener, que ve- 
remos em seguida, e o registramos para receber as atualizações oriundas do 
NETWORK PROVIDERe do GPS PROVIDER. 











Para registrar = um listener utilizamos o método 
requestLocationUpdates informando o provedor desejado, o intervalo 
de tempo em milissegundos e a distância em metros entre as atualizações. Ao con- 
figurar estes dois parâmetros como 0, isso indica que as atualizações de localização 


devem ser realizadas o mais frequentemente possível. 


public class LocalizacaoActivity extends Activity { 
private LocationManager locationManager; 
private TextView latitude, longitude, provedor; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView(R.layout.localizacao); 


latitude = (TextView) findViewById(R.id.latitude) ; 
longitude = (TextView) findViewById(R.id. longitude) ; 
provedor = (TextView) findViewById(R.id.provedor) ; 


locationManager = (LocationManager) 
this. getSystemService (Context . LOCATION_SERVICE) ; 
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Listener listener = new Listener(); 


long tempoAtualizacao = 0; 
float distancia = 0; 


locationManager .requestLocationUpdates ( 
LocationManager . NETWORK_PROVIDER, 
tempoAtualizacao, distancia, listener); 


locationManager .requestLocationUpdates ( 
LocationManager.GPS. PROVIDER, 
tempoAtualizacao, distancia, listener); 


Repare que registramos o listener para receber atualizações tanto do 
NETWORK PROVIDER como do GPS PROVIDER. 











Agora precisamos implementar um LocationListener que receberá as in- 
formações de localização e atualizará a tela com esses dados. Para isso, criamos uma 
classe privada chamada Listener. 

Quando a localização obtida por algum dos provedores for alterada, o método 
onLocat ionChanged é invocado com o nova localização sendo enviada como pa- 
râmetro. A classe Location fornece métodos para recuperar as informações de 
latitude, longitude e o provedor de origem. Utilizamos estes métodos para atualizar 
o valor dos TextViews.: 


private class Listener implements LocationListener{ 


@Override 

public void onLocationChanged(Location location) { 
String latitudeStr = String.value0f (location. getLatitude()); 
String longitudeStr = String.value0f (location. getLongitude()) ; 


provedor.setText (location. getProvider()) ; 
latitude.setText (latitudeStr) ; 
longitude. setText (longitudeStr) ; 


@Override 
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public void onStatusChanged(String provider, int status, 
Bundle extras) {} 


@Override 
public void onProviderEnabled(String provider) {} 


@Override 
public void onProviderDisabled(String provider) {} 


Para executar este exemplo e realizar os testes de localização é recomendável que 
seja utilizado um dispositivo Android ao invés do emulador. 

Caso não tenha um aparelho disponível, é possível utilizar o emulador e simular 
as localizações de GPS. Para isto, no Eclipse vá em Window> Show View> Other 





> Emulator Control. Uma nova aba como a mostrada na imagem 8.1 será aberta 
e nela poderemos enviar informações de localização simulada para o emulador. 
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Figura 8.1: Emulator Control 


Incluaa LocalizacaoActivity no manifesto, crie um botão no main.xml 
e altere o método escolherOpcao da HardwareActivity para iniciar a nova 
atividade: 


<!-- main.xml --> 
<?xml version="1.0" encoding="utf-8"?> 
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<LinearLayout...> 

<!-- botoes existentes --> 

<Button 
android: id="0+id/localizacao" 
android: layout width="match parent" 
android: layout height="wrap content" 
android: onClick="escolher0pcao" 
android: text="@string/testar_localizacao" /> 


</LinearLayout> 


public void escolherOpcao(View view) { 
//códigos existentes 
if(view.getId() == R.id.localizacao) { 
Intent intent = new Intent(this, LocalizacaoActivity.class) ; 
startActivity (intent) ; 


Agora sim! Execute a aplicação e veja a sua localização. Se estiver utilizando 
um dispositivo para testar, inicialmente a localização obtida será da rede e posteri- 
ormente do GPS, caso algum sinal seja obtido. A imagem 8.2 mostra como ficou a 
aplicação utilizando a localização. 


p OM RUE 


P = ull if 16h18 
Hardware 


Hardware 
network 
40.714728 
-73.998672 


gps 
40.714728 


-73.998672 





Figura 8.2: Emulator Control 


O próximo passo é utilizar essas informações de latitude e longitude para exibir a 
localização em um mapa. Para fazer isso, podemos utilizar o add-on Google APIs que 
conta com uma biblioteca para utilizar o Google Maps no Android através de uma 
MapView. No entanto, esta abordagem requer uma série de passos de preparação 
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que só é viável quando o aplicativo necessita manipular e interagir intensamente com 
mapas. 

No nosso exemplo, no qual queremos apenas exibir a localização, podemos uti- 
lizar a Google Static Maps API, que permite a recuperação de um mapa em formato 
de imagem, construído a partir de alguns parâmetros informados em uma URL. Re- 
sumindo, o que faremos é uma chamada para uma URL, informando as coordenadas 
da localização como parâmetro e receberemos como resposta uma imagem que é o 
mapa propriamente dito. 


Tanto a requisição para o serviço do Google como a exibição da imagem serão 





feitas utilizando uma view do Android chamada de WebView. A WebView permite 
a exibição de páginas da web que utiliza o mesmo engine do navegador disponível 
no Android. Ou seja, quando incluímos uma WebView em nosso aplicativo, temos 
praticamente todos os recursos do navegador padrão. 

Para carregar páginas da web em uma WebView, é necessário incluir a seguinte 
permissão no manifesto: 


<uses-permission android:name="android.permission. INTERNET" /> 


Em seguida, adicione uma WebView no arquivo de layout localizacao.xml 


dessa forma: 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout...> 
<!-- textviews existentes --> 
<WebView 
android: id="@+id/mapa" 
android: layout_width="wrap_content" 
android:layout height="wrap content" /> 
</LinearLayout> 


Na LocalizacaoActivity criaremos dois novos atributos. Um para a 
WebView e o outro para armazenar a URL base para o serviço de mapas estáticos. 


No método onCreate recuperamos a WebView para utilizá-la posteriormente. 


private String urlBase = "http://maps.googleapis.com/maps/api" + 
"/staticmap?size=400x400&ésensor=truekmarkers=color:red|%s,/8"3 
private WebView mapa; 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
// códigos existentes 
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mapa = (WebView) findViewById(R.id.mapa); 


A URL do serviço de mapas já está configurada com alguns parâmetros, que são 
o tamanho da imagem que deve ser retornada, uma flag indicando que as coorde- 
nadas foram obtidas de um sensor e as configurações do marcador da localização. 

O marcador terá a cor vermelha e será posicionado nas coordenadas de latitude 
e longitude, que serão incluídas no lugar dos %s. Estes são alguns dos parâmetros 
disponíveis na Google Static Maps API — para saber mais visite https://developers. 
google.com/maps/documentation/staticmaps/. 

Para exibir o mapa na WebView, basta montar a URL com as coordenadas e 
carregá-la com o método loadUrl, veja: 


@Override 

public void onLocationChanged(Location location) { 
// cédigos existentes 
String url = String.format(urlBase, latitudeStr, longitudeStr) ; 
mapa.loadUrl (url); 


Dessa forma, sempre que a localização mudar, um novo mapa será exibido. A 
imagem 8.3 demonstra como o mapa será exibido na aplicação de exemplo. É im- 
portante ressaltar que neste caso estamos utilizando uma configuração para receber 
as atualizações de localização o mais frequentemente possível. Em cenários reais isto 
não é recomendado, pois aumenta o consumo da bateria. 
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Figura 8.3: Emulator Control 


8.5 CONCLUSÃO 


Neste capítulo vimos como utilizar a câmera do dispositivo para incrementar nossas 
aplicações fazendo uso de imagens e vídeos. Também utilizamos o MediaPlayer 
para reproduzir músicas e vídeos tanto de arquivos armazenados no dispositivo 
como de arquivos da web. 

Através do GPS, recuperamos as coordenadas de latitude e longitude e exibimos 
a localização obtida utilizando um mapa gerado pela Google Static Maps API. 

Para facilitar o uso da Static Maps API, que é um serviço REST que retorna uma 
imagem, lançamos mão de uma WebView que permite renderizar páginas da web. 
Com estes conhecimentos é possível incrementar as funcionalidades dos seus aplica- 


tivos e que tal agora incluir no BoaViagem as coordenadas geográficas representando 
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o local onde o gasto foi realizado? Bons códigos! 
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CAPÍTULO 9 


Suporte Tablets e outros dispositivos 


A versão 4 do Android unificou a plataforma para a sua utilização tanto em tablets 
como smartphones. Antes disso tínhamos a versão 3.x projetada especificamente para 
tablets e a versão 2.x amplamente utilizada em smartphones e em alguns modelos de 
tablet. 

A versão 3.0 introduziu novos recursos de UI como a ActionBar e os 
Fragments, que são componentes de interface gráfica modulares, possuindo ciclo 
de vida próprio, e criados para facilitar o desenvolvimento de aplicativos com layouts 
diferentes para cada tipo de dispositivo. Para trazer alguns destes recursos para as 
versões anteriores do Android, o Google lançou um pacote de compatibilidade que 
permite a utilização de Loaders e Fragments, inclusive na versão 1.6 do Android. 

Neste capítulo veremos como utilizar o pacote de compatibilidade para utilizar 
os recursos mais recentes da plataforma, bem como conhecer as formas de suportar 
diversas versões do Android e vários tamanhos de tela, incluindo tablets. 


9.1. Prepare o seu ambiente Casa do Código 





9.1 PREPARE O SEU AMBIENTE 


Para implementar os exemplos deste capítulo será necessário fazer o download do 
pacote de compatibilidade e também criar um novo AVD para emular um tablet de 
10” com o Android 4.1 (Jelly Bean). 

O pacote de compatibilidade é obtido através do Android SDK Manager. No 
Eclipse, acesse o menu Window -> Android SDK Manager. Na janela apresentada, 
selecione a opção Android Support Library. Aproveite e também marque a 
opção Android 4.1 (API 16) para baixar esta versão, conforme mostra a imagem 
9.1. 





ana Android SDK Manager 





SDK Path: /Users/joao/Dev/android-sdk-mac xB6/ 
Packages 


Status 
| > LJ Tools 

> |=) Android 4.1 (API 16) 
P iz) Android 4.0.3 (API 15) 
> [E] Android 4.0 (API 14) 
|=) Android 3.2 (API 13) 
> iz] Android 3.1 (API 12) 
> iz! Android 3.0 (API 11) 
> =) Android 2.3.3 (API 10) 
> (=) Android 2.2 (API 8) 

> | =) Android 2.1 (API 7) 

P L5] Android 1.6 (API 4) 

> (=) Android 1.5 (API 3) 











| Wj Extras 
EB Android Support Library + Not installed 
BE Google AdMob Ads SDK Ẹ Not installed 
EB Google Analytics SDK Ẹ Not installed 
BE Google Cloud Messaging for Android Library + Not installed 
EE Google Play APK Expansion Library + Not installed 
EB Google Play Billing Library + Not installed 
EE Google Play Licensing Library + Not installed 
Show: (M Updates/New (installed | | Obsolete Select New or Updates | Install 1 package... | 
Sort by: (2) API level 1) Repository Deselect All | Delete 6 packages... | 





Done loading packages. 





Figura 9.1: Android Support 


Depois que os downloads acabarem, abra o AVD Manager através do menu 
Window do Eclipse e crie um novo AVD com os dados ilustrados na imagem 9.2 
para emular um tablet. 
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| @ © © Create new Android Virtual Device (AVD) 

Name: Tabletl 

Target: Google APIs (Google Inc.) - API Level 16 

CPU/ABI: ARM (armeabi-v7a 

SD Card: = — 
(e) Size: fe | GB =| 
\_) File: Browse 

Snapshot: 

ci M Enabled 

Skin: = r 
(e) Built-in: | WXGA800 
\_) Resolution: x 

Hardware: Trea Value Gas 
Abstracted LCD density 160 
Keyboard lid support no Delet 
Max VM application hea... 48 
Device ram size 1024 

a de th ] D 
Cancel | Create AvD | 





Figura 9.2: Emulando um tablet 


Note que a opção Snapshot foi habilitada. Este recurso permite que o estado 
do emulador seja salvo em disco, reduzindo consideravelmente o tempo de sua ini- 
cialização depois que o mesmo é iniciado pela primeira vez. 

Também é necessário incluir o pacote de compatibilidade no projeto do Eclipse. 
Para isto, vá no diretório de instalação do SDK, na pasta extras/android/v4 e 
copie o arquivo android-support-v4. jar para apasta libs do projeto. 


9.2 SUPORTE VÁRIAS VERSÕES DO ANDROID 


O Android pode ser executado em uma quantidade bastante diversificada de dispo- 
sitivos. Por um lado, isso aumenta a gama de usuários e por outro, torna necessário 
que os desenvolvedores levem em consideração qual público/dispositivos irão aten- 
der com seus aplicativos. 

A versão 2.x do Android é a que possui a maior base instalada e espera-se que, 
com o aumento do número de tablets Android e com o lançamento da versão 4, esta 
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situação mude. A imagem 9.3 mostra a participação de cada versão com base nos 


dispositivos que acessam o Google Play. 


vein | Codename | a | Disviouion | 
1.5 








Cupcake 3 0.2% 
16 Donut 4 0.4% 
21 Eclair 7 3.7% 
2.2 Froyo 8 14% 

Gingerbread 

2.3- Gingerbread 9 0.3% 
2.3.2 
2.3.3- 10 57.2% 
23.7 
3.1 Honeycomb 12 0.5% 
3.2 13 1.6% 
4.0- Ice Cream 14 0.1% 
4.0.2 Sandwich 
4.0.3 - 15 20.8% 
4.0.4 
4.1 Jelly Bean 16 1.2% 


Data collected during a 14-day period ending on September 4, 2012 


Figura 9.3: Version Share 







Honeycomb 


ice Cream Sandwich 


Jelly Bean 


Rm — Eclair & alder 


Froyo 


O Google recomenda que o seu aplicativo seja compativel com cerca de 90% da 


base instalada. De acordo com os dados de Junho de 2012, para atender esta meta, 


nosso aplicativo BoaViagem, desenvolvido utilizando a versão 2.3.3, deveria ser com- 


patível também com as versões 2.2 e 2.1 do Android. 


Manter a compatibilidade com versões anteriores exige que se abra mão de recur- 


sos disponíveis em APIs mais recentes, ou pior, manter códigos específicos para cada 


versão, causando duplicação. Nos casos em que é necessário verificar, em tempo de 


execução, qual é a versão do Android, utilizamos as informações contidas na classe 


Build. Veja como fica um código que verifica se o aplicativo está sendo executado 


em uma versão superior a 1.6 para decidir como realizar determinada operação: 


private void algumaQperacao() { 


if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.DONUT) { 


// usar api nova 
} else { 
// usar api antiga 
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Geralmente, quando sai uma nova versão do Android, novos atributos para os 
XMLs também são incluídos. Isso quer dizer que teremos versões diferentes de 
XMLs para cada versão? Felizmente, não. O Android automaticamente ignora estes 
novos atributos quando o aplicativo estiver sendo executado em uma versão anterior 
que não os possui. 

Para definir quais versões nosso aplicativo suporta, devemos declarar no 
AndroidManifest.xml qual é a versão mínima e também qual é a versão alvo, 
ou seja, a versão na qual o aplicativo foi desenvolvido, testado e sabe-se que funci- 
ona corretamente. Veja um exemplo onde a versão mínima é a 2.2 (API 8) e a versão 
alvo é a 41 (API 16): 


<manifest ... > 
<uses-sdk android:minSdkVersion="8" android: targetSdkVersion="16" 
<!-- demais declarações --> 

</manifest> 


Além de restringir por versões, também podemos restringir a instalação do apli- 
cativo com base nas características e recursos disponíveis nos dispositivos. Podemos, 
por exemplo, restringir que nosso aplicativo só seja instalado em um dispositivo que 
possua câmera e GPS: 


<manifest ... > 
<uses-feature android:name="android.hardware.location.gps" /> 
<uses-feature android:name="android.hardware.camera" /> 
<!-- demais declarações --> 

</manifest> 


Para uma relação completa de todas os filtros que podem ser aplicados para im- 
pedir que seu aplicativo seja instalado por um dispositivo que nao oferece os recursos 
necessários, visite http://developer.android.com/guide/google/play/filters.html. Es- 
tas configurações não são obrigatórias mas sem dúvida auxiliam a direcionar seu 


aplicativo apenas para os dispositivos que possam executá-lo corretamente. 


9.3 SUPORTE DIVERSOS TAMANHOS DE TELA 


Atualmente existe uma grande variedade de dispositivos rodando a plataforma An- 
droid, desde smartphones com telas compactas, tablets de diferentes tamanhos e até 
mesmo Smart T'Vs com telas que ultrapassam 32 polegadas. 
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Para que o usuário tenha uma boa experiência de uso, independentemente do 
dispositivo que esteja utilizando, é importante que seu aplicativo suporte vários tipos 
de tela, tirando proveito das telas maiores para exibir mais conteúdo e otimizando a 
visualização de informações no caso das telas menores. 

Para cada tamanho de tela que se deseja suportar, um layout diferente deve ser 
definido e de acordo com o dispositivo que está executando a aplicação, o Android 
aplica o layout adequado. 

Na plataforma Android as telas são classificadas de acordo com duas característi- 
cas principais: a densidade e o tamanho. A densidade se refere à quantidade de pixels 
existentes em uma determinada área da tela (uma polegada), cuja unidade de me- 
didaéo dpi (dots per inch). Por simplificação, o Android define quatro densidades: 
baixa ( 1dpi), média ( mapi), alta ( hapi), extra alta ( xhdpi). 

A densidade deve ser levada em consideração quando estamos definindo as di- 
mensões dos componentes de Ul e também quando estamos confeccionando as ima- 
gens ( drawables) que serão utilizados no aplicativo. Supondo que temos uma 
imagem com tamanho 100x100 para uma tela de densidade média, para atender as 
demais densidades teremos outras versões com tamanho 75x75 para baixa, 150x150 
para alta e 200x200 para extra alta densidade. A escala utilizada para determinar o 
tamanho das imagens de acordo com a densidade é a seguinte: 


e Idpi - 0.75 


e mdpi - 1.0 


hdpi - 1.5 


e xhdpi - 2.0 


Uma vez criadas, as imagens devem ser colocadas nos diretórios de drawables 
específicos para cada densidade, veja um exemplo: 


BoaViagem/ 
res/ 

drawable-xhdpi/ 
configuracoes.png 

drawable-hdpi/ 
configuracoes.png 

drawable-mdpi/ 
configuracoes.png 
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drawable-ldpi/ 
configuracoes. png 


De acordo com a densidade do dispositivo, o Android escolhera a imagem ade- 
quada em tempo de execução. Caso você não forneça imagens para cada tipo de 
densidade, o Android fará por conta própria o redimensionamento das imagens o 
que pode levar a perda de qualidade. No entanto, se a única imagem disponível se 
refere a uma densidade maior do que a disponível, o Android lançará um erro. 

Já o tamanho se refere ao tamanho físico da tela, medido pelo comprimento (em 
polegadas) da diagonal da tela. Alguns exemplos de tamanho de tela são as de 4.7", 
7"e 10.1" polegadas. O Android agrupa as telas em quatro tamanhos: pequena ( 
small), normal ( normal), grande ( large) e extra grande (extra large). 

Além disso, ainda existe a orientação da tela que pode ser retrato (portrait) ou 
paisagem (landscape), de acordo com o ponto de vista do usuário. O seu aplicativo 
deve levar em conta as mudanças de orientação do dispositivo que acontecem em 
tempo de execução para ajustar o layout conforme necessário. Podemos criar layouts 
para tamanhos e orientação de tela específicos. Para isto basta criar o layout desejado 
e colocá-lo no diretório correspondente, seguindo a convenção: 


res/layout-<tamanho da tela>-<orientacao> 


// exemplos 
res/layout-small-port 
res/layout-normal-land 


Como existe uma variedade grande de tamanhos de tela, com densidades dis- 
tintas, o Android define uma unidade de medida virtual, o density-independent pixel 
( dp), que deve ser utilizada para expressar dimensões de layout e posições inde- 
pendentemente da densidade da tela. Um dp equivale a um pixel físico em uma 
tela de 160 dpi, que é a densidade padrão assumida pelo Android para uma tela de 
densidade média ( mdpi). 

Ele automaticamente faz as conversões e redimensionamentos das medidas em 
dp para pixels físicos de acordo com a densidade da tela em uso. 

Também existe uma medida relativa para a definição de tamanho dos textos, o 
sp (scale-independent pixel). O sp se assemelha ao dp, com a diferença de que é 
redimensionado de acordo com as preferências de texto do usuário. O sp deve ser 
utilizado unicamente para a definição do tamanho de textos, nunca para dimensões 
de layout. Veja alguns exemplos de uso: 
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<Button android:layout width="wrap content" 
android: layout height="wrap content" 
android: text="@string/gastei" 
android: layout_marginTop="25dp" /> 


<TextView 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: text="@Qstring/local" 
android: textSize="20sp" /> 


A partir da versão 3.2 do Android, a forma de definir o layout de acordo com 
o tamanho da tela ( small, normal, large e extra large) foi depreciada. 
Agora podemos defini-los de acordo com a largura ou altura disponíveis em dp. 
É possível, por exemplo, definir um layout que deve ser exibido quando a largura 
da tela for de, no mínimo, 600 dp, colocando o arquivo XML correspondente no 
diretório res/layout-sw600dp. 

O qualificador sw quer dizer smallest width. A largura mínima ( sw) se refere à 
largura especificada pelo dispositivo (600x1024 mdpi em um tablet de 7”, por exem- 
plo), portanto, seu valor não é alterado quando a orientação muda. Podemos utilizar 
o qualificador w para indicar a largura disponível, não importando se ela foi alterada 
por conta da mudança de orientação. Veja outros exemplos: 


res/layout-w600dp/main.xml // a largura deve ser de 600dp 
res/layout-h320dp/main.xml // altura mínima de 320dp 


Se for necessário restringir para que o aplicativo não seja instalado em um dis- 
positivo que não possui o tamanho de tela suportado, podemos incluir uma diretiva 
no AndroidManifest .xml que pode conter ainda a densidade de tela requerida. 
Veja como declarar esta restrição utilizando o <supports-screens>: 


<supports-screens android:resizeable=["true"| "false"] 
android:smallScreens=["true" | "false"] 
android:normalScreens=["true" | "false"] 
android: largeScreens=["true" | "false"] 
android:xlargeScreens=["true" | "false"] 
android:anyDensity=["true" | "false"] 


android: requiresSmallestWidthDp="integer" 
android: compatibleWidthLimitDp="integer" 
android: largestWidthLimitDp="integer"/> 


Nesse caso, você pode indicar para cada tipo de tela se ele será suportado ou não. 
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9.4 UTILIZE FRAGMENTS PARA SIMPLIFICAR SEUS 
LAYOUTS 


Os Fragments são componentes modulares de interface gráfica, com um ciclo de 
vida próprio, criados para facilitar o desenvolvimento de aplicativos com layouts 
ajustáveis a diferentes tamanhos de tela. Este recurso foi adicionado no Android 
3 e disponibilizado para as versões anteriores através de uma biblioteca de compati- 
bilidade. 

A ideia é que um Fragment possa representar orauma Activity única, sendo 
exibida em um dispositivo com tela compacta, ora uma parte de uma Activity 
que também exibe outros Fragments no caso de um tablet. É o que demonstra a 
imagem 9.4. 








Figura 9.4: Exibição de Fragments 


Um Fragment deve necessariamente fazer parte de uma Activity eo seu 
ciclo de vida é afetado por ela. Por exemplo, quando uma atividade é destruída, 
todos os seus fragments também são. 

Outra característica importante é que os Fragments podem ser adicionados 
e removidos da atividade em tempo de execução, trazendo flexibilidade para a cri- 
ação de um fluxo de interação com o usuário que leva em conta o dispositivo que 
está sendo utilizado. Para adicionar um Fragment a uma Activity, podemos 
declará-lo no layout da mesma, através do elemento <fragment> ou adicioná-lo 
programaticamente a um ViewGroup (todos os layouts herdam desta classe) já exis- 
tente. 


Retornaremos ao aplicativo BoaViagem para implementar uma nova funcionali- 
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dade que tirará proveito da tela maior de um tablet. Como uma espécie de diário de 
bordo, esta funcionalidade consiste em registrar anotações diversas sobre a viagem. 
A imagem 9.5 ilustra como os fragments serão utilizados. 


Destino O 02/07/2012 00:28 - gasto 0 - R$00 
Destino 1 02/07/2012 00:28 - gasto 1 - R$ 20 
Destina 2 02/07/2012 00:28 - gasta 2» R$ 40 
gasto 3-RS6.0 
02/07/2012 00:28 - gasto 4 - R$ 8.0 

02/07/2012 00:28 - gasto 5 - R$ 10.0 


02/07/2012 00:28 - gasto 6 - RS 12.0 


02/07/2012 00:28 - gasto 7 - R$ 14.0 


02/07/2012 00:28 - gasto 8 - R$ 16.0 
02/07/2012 00:28 -gasto 9 - AS 18.0 
02/07/2012 00:28 - gasto 10- R$ 20.0 


EMENDA -naeta 17 - AS 27 





Figura 9.5: Utilizando Fragments 


Como o foco é o uso da API de Fragments, não iremos nos preocupar 
em recuperar as informações do banco de dados e nem criar layouts persona- 
lizados para as listagens. Começaremos esta nova versão implementando um 
Fragment para a lista de viagens. Por questões de organização, crie um novo 
pacote br.com.casadocodigo.boaviagem. fragment para manter todos os 
Fragments que serão criados. 

De forma análoga à ListActivity, para utilizar uma ListView pode- 
mos estender a classe ListFragment. Crie então uma nova classe com nome de 
ViagemListFragment que estende de ListFragment. Além disso, para tratar o 
evento de quando um item da lista for selecionado, nossa nova classe deverá imple- 
mentar $OnItemClickListener, veja: 


public class ViagemListFragment extends ListFragment 
implements OnItemClickListener { 
@Override 
public void onStart() + 
} 
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@Override 

public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 


Diferentemente do método onCreate da Activity, ométodo onCreate de 
um Fragment é executado antes da criação da sua view correspondente, o que em 
outras palavras quer dizer que não temos como acessar componentes de interface 
gráfica neste método, pois os mesmos ainda nem foram criados. Por isso, iremos 
sobrescrever o método onStart, que é executado quando o Fragment já está 
pronto para ser exibido, para realizar as implementações necessárias. Veja o código: 


@Override 

public void onStart() { 
super.onStart(); 
List<String> viagens = Arrays.asList ("Campo Grande", "São Paulo", 

"Miami") ; 
ArrayAdapter<String> adapter = 
new ArrayAdapter<String>(getActivity(, 
android.R.layout.simple list item 1, viagens); 

setListAdapter (adapter); 
getListView().setOnItemClickListener (this); 


No método onStart criamos uma lista simulada de viagens e um 
ArrayAdapter com a lista criada para alimentar a ListView que será exibida. 
Também atribuímos o próprio Fragment como o responsável por tratar os eventos 
de seleção de itens da listagem. 

O mínimo necessário para o nosso primeiro Fragment já foi implementado. Na 
sequência iremos criar uma Activity para controlar a exibição dos Fragments 
que compõem está nova funcionalidade. Para isto, precisaremos criar dois layouts, 
um deles será utilizado para tablets e outro para dispositivos com telas menores. 

No layout destinado a tablets utilizaremos três Fragments enquanto no outro 
apenas um. Crie um novo XML de layout chamado anotacoes. xml e coloque-o 
no diretório res/layout. A definição deste layout é a seguinte: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout width="match parent" 
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android: layout height="match parent" 
android:orientation="vertical" > 


<FrameLayout 
android: id="0+id/fragment unico" 
android: layout width="wrap content" 
android:layout height="match parent" /> 


</LinearLayout> 


Repare que não declaramos um elemento <fragment > no layout. Em vez disso, 
incluímos um FrameLayout, o qual será substituído em tempo de execução pelo 
Fragment que deve ser exibido. 

Para o tablet, crie um novo layout com o mesmo nome ( anotacoes. xml), po- 
rém, coloque-o no diretório res/layout-large-land. Este layout será utilizado 
quando o dispositivo estiver com a orientação paisagem e possuir uma tela classifi- 
cada como grande. 

Neste layout definiremos três fragments mas como ainda não criamos todos 
eles, declararemos apenas um, e dois FrameLayouts para simular o espaço ocu- 
pado pelos outros fragments, veja: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="horizontal" > 


<fragment 
android: id="@+tid/fragment_viagens" 
android:name= 
"br.com. casadocodigo.boaviagem.fragment .ViagemListFragment" 
android: layout_width="0dp" 
android: layout_height="match_parent" 
android: layout_weight="1" /> 


<FrameLayout 
android: id="@+id/fragment_anotacoes" 
android: layout width="0dp" 
android: layout height="match parent" 
android:layout weight="1" > 
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<TextView 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:text="FRAGMENT B" /> 
</FrameLayout> 


<FrameLayout 
android: id="@+id/fragment_anotacao" 
android: layout width="0dp" 
android: layout height="match parent" 
android:layout weight="1" > 


<TextView 
android: layout width="wrap content" 
android:layout height="wrap content" 
android:text="FRAGMENT C" /> 
</FrameLayout> 


</LinearLayout> 


O atributo name do elemento <fragment> deve ser o nome qualificado da 
classe que o implementa. O próximo passo será criar a classe AnotacaoActivity 
que controlará a exibição dos fragments e a comunicação entre eles. Iniciaremos 


a implementação desta classe com o código a seguir: 
public class AnotacaoActivity extends FragmentActivity { 
private boolean tablet = true; 
@Override 
protected void onCreate(Bundle bundle) { 
super .onCreate (bundle) ; 
setContentView(R. layout .anotacoes) ; 


View view = findViewById(R.id.fragment unico); 


if (view != null)f{ 


tablet = false; 


ViagemListFragment fragment = new ViagemListFragment () ; 
fragment .setArguments (bundle) ; 


265 


9.4. Utilize Fragments para simplificar seus layouts Casa do Código 





FragmentManager manager = getSupportFragmentManager () ; 
FragmentTransaction transaction = 

manager . beginTransaction() ; 
transaction.replace(R.id.fragment_unico, fragment) ; 
transaction.addToBackStack(null) ; 
transaction.commit() ; 


Repare que a classe estende de FragmentActivity em vez de Activity. A 
classe FragmentActivity pertence ao pacote de compatibilidade e através dela 
podemos utilizar os recursos da API de Fragments em versões do Android anteri- 
ores à versão 3. No entanto, se o seu aplicativo tiver como alvo a versão 3 ou superior, 
então você deve utilizar a classe Activity que já implementa a API nessas versões. 

No método onCreate atribuímos a view identificada por 
R. layout .anotacaoes paraa activity. Em tempo de execução, o Android 
decidirá se irá utilizar o anotacoes.xml da pasta layout ou aquele localizado 
em layout-large-land, de acordo com o dispositivo que está em uso. Por 
isso, tentamos recuperar o FrameLayout com o id R.id.fragment unico 
para determinar qual layout está sendo utilizado. Se esta view existir, então o 
dispositivo em uso não é um tablet e é necessário exibir um Fragment por vez. 

Em seguida, instanciamos o ViagemListFragment que é o primeiro a ser 
exibido para o usuário. Na linha seguinte, atribuímos um bundle que é utili- 
zado para a construção e inicialização do Fragment. O que é feito em seguida é 
substituir o FrameLayout existente pelo recém-criado ViagemListFragment. 
Para isto, utilizamos uma FragmentTransaction que é iniciada através do 
FragmentManager. 

Por fim, invocamos o método replace da FragmentTransaction in- 
formando no primeiro parâmetro qual é a view que deve ser substituída, e no 
segundo, qual é o Fragment que deve ser colocado em seu lugar. O método 
addToBackStack é utilizado para incluir a transação na back stack, o que na prá- 
tica quer dizer que este Fragment estará disponível quando o usuário estiver em 
outra tela e pressionar o botão “Voltar”. Então é feito o commit da transação para 
efetivar a operação de substituição. 

Quando a aplicação estiver executando em um tablet, nada de diferente precisa 
ser feito, pois no layout já temos a declaração dos Fragments que devem ser exi- 
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bidos. Para executar esta nova funcionalidade, declare a AnotacaoActivity no 
manifesto e crie uma nova opção na dashboard para iniciá-la. Utilizando o emulador 
de tablets criado previamente para executar o aplicativo, o resultado obtido deve ser 
semelhante ao exibido na imagem 9.6. 


Campo Grande 


São Paulo 


Miami 





Figura 9.6: Fragment da lista de viagens 


Dando continuidade, iremos implementar os demais Fragments e programar 
a comunicação entre eles. Quando o usuário selecionar uma viagem da lista, de- 
vemos exibir as anotações associadas àquela viagem no segundo Fragment. Ao 
selecionar uma anotação da lista, o terceiro Fragment exibirá as informações da- 
quela anotação. Este é o funcionamento desejado para o tablet. Caso contrário, 
cada Fragment deverá ser exibido individualmente e quem controlará isto será a 
AnotacaoActivity. 

O segundo Fragment, além de exibir uma ListView com as anotações já 
realizadas, também terá uma botão que permite a criação de uma nova anotação. 
Então, precisaremos de um layout que possua um botão e uma ListView. Ele será 
utilizado pelo Fragment de anotações, tanto para smartphones como tablets. 


Crie um novo XML no diretório res/layout com nome de 
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lista anotacoes.xml, dessa forma: 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="Vertical" > 


<Button 
android: id="@+id/nova_anotacao" 
android: layout_width="match_parent" 
android:layout height="wrap content" 
android:text="Qstring/nova anotacao" /> 


<ListView 
android: id="@android:id/list" 
android: layout width="match parent" 
android:layout height="wrap content" > 
</ListView> 


</LinearLayout> 


Para utilizarmos um ListFragment com um layout que contém mais wid- 
gets, além da ListView, é obrigatório declarar uma ListView como id 
Gandroid:id/list. 

Com o layout já definido, crie uma nova classe para a lista de anotações, com o 
nome de AnotacaoListFragment. O código inicial desta classe será o seguinte: 


public class AnotacaoListFragment extends ListFragment 
implements OnItemClickListener, OnClickListener { 


@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
return inflater.inflate(R.layout.lista_anotacoes, 
container, false); 


@Override 
public void onStart() { 
super .onStart () ; 
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@Override 

public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 


@Override 
public void onClick(View v) { 
} 


O layout que será utilizado pelo Fragment é construído no onCreateView, 
que criaa view através do método LayoutInflater.inflate. 

A AnotacaoListFragment implementa duas interfaces, a 
OnItemClickListener para tratar eventos da lista de anotações e a 
OnClickListener para tratar o evento do botão que cria uma nova anota- 
ção. Quando estávamos lidando apenas com activities, nós colocávamos no atributo 





onClick do elemento <Button> o nome do método que deveria ser invocado. 
No entanto, este recurso não está disponível para os Fragments. 


No método onStart além de criar uma lista e um adapter paraa ListView, 
também precisaremos atribuir o onClickListener, que é o próprio Fragment, 
para o botão R.id.nova_anotacao. Veja como fica a implementação deste mé- 
todo: 


@Override 
public void onStart() { 
super.onStart(); 
List<Anotacao> anotacoes = listarAnotacoes(); 


ArrayAdapter<Anotacao> adapter = 
new ArrayAdapter<Anotacao>(getActivity() , 
android.R.layout.simple list item 1, 
anotacoes) ; 


setListAdapter (adapter) ; 
getListView() .setOnItemClickListener (this); 
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Button button 


(Button) getActivity( .findViewById(R.id.nova_anotacao) ; 
button. setOnClickListener(this); 


private List<Anotacao> listarAnotacoes() { 


List<Anotacao> anotacoes = new ArrayList<Anotacao>() ; 


for (int i = 
Anotacao 


anotacao. 
anotacao. 
anotacao. 


1; i <= 20; i++) { 
anotacao = new Anotacao(); 
setDia(i); 
setTitulo("Anotacao " + i); 


setDescricao("Descrição " + i); 


anotacoes.add(anotacao) ; 


return anotacoes; 


O ArrayAdapter invoca o método toString dos objetos da lista pas- 


sada como parâmetro, para obter o valor que deve ser colocado em cada linha da 


ListView. Então sobrescrevemos o método toString da Anotacao para retor- 


nar o dia e o título da mesma. 


A classe Anotacao, que representa uma anotação feita pela usuário, é definida 


como: 


public class Anotacaof{ 


private Long id; 


private Integer dia; 


private String titulo; 


private String descricao; 


// getters e setters 


@Override 


public String toString() { 
return "Dia "+ dia + " - " + titulo; 
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Para que o novo AnotacaoListFragment seja visualizado, precisamos incluí- 


lo no layout para tablets. Basta alterar o arquivo anotacoes.xml do diretório 


layout-large-land para indicar o novo fragment criado: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android: layout width="match parent" 


android: layout height="match parent" 


android:orientation="horizontal" > 


<!-- fragment ViagemListFragment --> 
<fragment 
android: id="0+id/fragment anotacoes" 
android:name= 
"br.com. casadocodigo.boaviagem. fragment .AnotacaoListFragment" 


android: 
android: 
android: 


layout width="0dp" 
layout height="match parent" 
layout weight="1" /> 


<!-- FrameLayout FRAGMENT C --> 


</LinearLayout> 


Ao executar a aplicação no emulador de tablet, veremos uma tela semelhante à 


apresentada na imagem 9.7. No entanto, se o tablet estiver na orientação retrato ou 


um smartphone estiver executando o aplicativo, o único Fragment exibido conti- 


nua sendo o da lista de viagens. Antes de nos preocuparmos com esta questão vamos 


primeiro finalizar o último Fragment que exibirá os detalhes da anotação selecio- 


nada. 
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Campo Grande 


a Dia 1 - Anotacao 1 
São Paulo 


Dia 2 - Anotacao 2 


Miami 


Dia 3 - Anotacao 3 


Dia 4 - Anotacao 4 


Dia 5 - Anotacao 5 


Dia 6 - Anotacao 6 


Dia 7 - Anotacao 7 


Dia 8 - Anotacao 8 


Dia 9 - Anotacao 9 


Dia 10 - Anotacao 10 


Dia 11 - Anotacao 11 





Figura 9.7: Fragment da lista de viagens 





MUDANDO A ORIENTAÇÃO NO EMULADOR 


No emulador, para mudar a orientação entre retrato e paisagem e vice- 
versa basta pressionar Ctr1+F12. 











Crie um novo XML de layout, com nome de anotacao.xm1, no local padrão 
para ser utilizado pelo Fragment de detalhes da anotação. Este layout terá widgets 





básicos como Text Views para a descrição dos campos, Edit Texts para o usuário 
informar os dados, além de um Button, para confirmar. 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android= 

android: layout_width= 

android: layout_height= 

android: orientation= > 


<TextView 
android: layout width= 
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android: 
android: 


<EditText 


android: 
:layout width="50dp" 
android: 


android 


android: 


<TextView 


android: 
android: 
android: 


<EditText 


android: 
android: 


android 


android: 


<TextView 
android 


android: 
android: 


<EditText 


android: 
android: 


android 


android: 


<Button 


android: 
android: 
android: 


android 


</LinearLayout> 


layout height="wrap. content" 
text="Qstring/dia" /> 


id="@+id/dia" 
layout_height="wrap_content" 


inputType="number" /> 


layout width="wrap content" 
layout height="wrap content" 
text="Ostring/titulo" /> 


id="@+id/titulo" 
layout_width="match_parent" 


:layout_height="wrap_content" 


inputType="text" /> 


: Layout_width="wrap_content" 


layout_height="wrap_content" 
text="Qstring/descricao" /> 


id="@+id/descricao" 
layout_width="match_parent" 


:layout_height="Odp" 
android: 


layout_weight="1" 


inputType="textMultiLine" /> 


id="@+id/salvar" 
layout_width="match_parent" 
layout_height="wrap_content" 


:text="Ostring/salvar"/> 


Como neste caso não precisaremos de uma ListView, vamos criar uma nova 
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classe, que herda de Fragment, com o nome de AnotacaoFragment. Também 
implementaremos OnClickListener para tratar a operação de salvar. O código 
inicial dessa classe será o seguinte: 


public class AnotacaoFragment extends Fragment 
implements OnClickListener { 


private EditText dia, titulo, descricao; 
private Button botaoSalvar; 
private Anotacao anotacao; 


@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
return inflater.inflate(R.layout.anotacao, container, false); 


@Override 
public void onStart() { 
super .onStart () ; 


dia = (EditText) getActivity( .findViewById(R.id.dia) ; 
titulo = (EditText) getActivity(© .findViewByld(R.id.titulo) ; 
descricao = 

(EditText) getActivity() .findViewById(R.id.descricao) ; 
botaoSalvar = (Button) getActivity( .findViewById(R.id.salvar) ; 
botaoSalvar.setOnClickListener (this) ; 


@Override 
public void onClick(View v) { 
// salvar Anotacao no banco de dados 


} 
} 

Agora basta incluir o AnotacaoFragment no anotacoes.xml que ficará 
assim: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="horizontal" > 
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<fragment 
android: id="0+id/fragment viagens" 
android:name= 
"br.com. casadocodigo.boaviagem. fragment .ViagemListFragment" 
android: layout width="0dp" 
android: layout height="match parent" 
android:layout weight="1" /> 


<fragment 
android: id="0+id/fragment anotacoes" 
android:name= 
"br.com. casadocodigo. boaviagem. fragment. AnotacaoListFragment " 
android: layout width="0dp" 
android: layout height="match parent" 
android:layout weight="1" /> 


<fragment 
android: id="0+id/fragment anotacao" 
android:name= 
"br.com. casadocodigo.boaviagem. fragment .AnotacaoFragment" 
android: layout width="0dp" 
android: layout height="match parent" 
android:layout weight="1" /> 


</LinearLayout> 


Ao executar a aplicação novamente já visualizaremos o layout completo com to- 
dos os Fragments criados, como mostra a imagem 9.8. 


275 


9.5. Comunicação entre Fragments Casa do Código 








Campo Grande 


3 Dia 1 - Anotacao 1 
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Miami 


Dia 3 - Anotacao 3 


Dia 4 - Anotacao 4 


Dia 5 - Anotacao 5 


Dia 6 - Anotacao 6 


Dia 7 - Anotacao 7 


Dia 8 - Anotacao 8 


Dia 9 - Anotacao 9 


Dia 10 - Anotacao 10 


Dia 11 - Anotacao 11 





Figura 9.8: Fragment da lista de viagens 


9.5 (COMUNICAÇÃO ENTRE FRAGMENTS 


Já construímos os Fragments necessários para o registro de anotações. Nesta seção 
veremos como trocar informações entre Fragments para completar a implemen- 
tação desta nova funcionalidade do aplicativo BoaViagem. 

Para que possamos facilmente reutilizar um Fragment é necessário que ele seja 
implementado como um componente modular, possuindo o seu próprio layout e 
comportamento. Dessa forma, podemos utilizar o mesmo Fragment para compor 
telas distintas que variam conforme o dispositivo em uso. 

Um Fragment sempre está atrelado a uma Activity e é ela quem deve orques- 
trar a comunicação entre seus Fragments, inclusive controlar quais deles devem 
ser exibidos. Já iniciamos uma implementação assim na AnotacaoActivity que 
verifica se serão exibidos vários Fragments ou apenas um. 

Para completar a funcionalidade de registro de anotações, nesta Activity im- 
plementaremos a lógica de trocar o Fragment exibido quando o aplicativo estiver 
sendo utilizado em um smartphone e for necessário apresentar um por vez. Tam- 


bém faremos a comunicação e a passagem de dados de um para outro utilizando 
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esta Activity. 

Os Fragments não devem se comunicar diretamente, por isso é recomendado 
que seja definida uma interface com as operações que os eles devem notificar. A 
Activity responsável por coordená-los deve implementar esta interface e to- 
mar as ações necessárias, geralmente invocando algum método de outro Fragment. 

No nosso caso, o ViagemListFragment deve notificar a 
AnotacaoActivity quando uma viagem for selecionada na lista. O mesmo 
acontece com a AnotacaoListFragment, que além de informar qual item da 
ListView foi selecionado, também notifica quando o usuário pressiona o botão 
para criar uma nova anotação. Vamos criar uma interface com nome de 


AnotacaoListener para definir estes comportamentos, veja o código: 


public interface AnotacaoListener { 
void viagemSelecionada (Bundle bundle); 
void anotacaoSelecionada(Anotacao anotacao); 
void novaAnotacao(); 


No ViagemListFragment, invocaremos o método viagemSeleciona 
quando o usuário escolher um item da lista. Para isto, precisaremos de uma refe- 
rência paraa Activity que implementaa AnotacaoListener. Podemos obtê-la 
sobrescrevendo o método onAttach do Fragment. Na implementação do método 
onItemClick, recuperaremos o item selecionado da List View, colocando-o em 
um Bundle, que será passado como parâmetro do método viagemSelecionada. 
Veja como ficou: 


public class ViagemListFragment extends ListFragment 
implements OnItemClickListener { 
// novo atributo 
private AnotacaoListener callback; 


// cédigos existentes 


@Override 
public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 
String viagem = (String) getListAdapter() .getItem(position) ; 
Bundle bundle = new Bundle(); 
bundle.putString(Constantes.VIAGEM SELECIONADA, viagem); 
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callback.viagemSelecionada (bundle); 


@Override 

public void onAttach(Activity activity) { 
super .onAttach (activity); 
callback = (AnotacaoListener) activity; 


public class Constantes { 
// nova constante 
public static final String VIAGEM SELECIONADA = 
"viagem selecionada"; 


Na classe AnotacaoListFragment precisaremos disponibilizar um método, 
que será chamado pela AnotacaoActivity, para listar as anotações de uma vi- 
agem, recebendo por parâmetro o bundle que foi passado pelo outro Fragment 
contendo a viagem selecionada. 

Criaremos um método, chamado listarAnotacoesPorViagem, que verifi- 
cara se alguma viagem foi informada através do bundle recebido como parâmetro. 
Ele cria uma lista de anotações fictícias para alimentar a ListView, no entanto, 
seria facilmente adaptável para recuperar as informações do banco de dados, caso 
necessário. 

Modificaremos o método onStart, para também utilizar o 
listarAnotacoesPorViagem. Dessa forma, quando o Fragment for ini- 
cializado programaticamente pela AnotacaoActivity, a lista de anotações 
também será carregada. 


@Override 
public void onStart() { 
super .onStart (); 
Button button = 
(Button) getActivity().findViewById(R.id.nova anotacao); 
button. setOnClickListener(this); 
getListView() .setOnItemClickListener (this); 
listarAnotacoesPorViagem(getArguments()) ; 
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public void listarAnotacoesPorViagem(Bundle bundle) { 
if(bundle != null && 
bundle. containsKey (Constantes .VIAGEM_SELECIONADA) ) { 


//utilize a informação do bundle para buscar 
// as anotacoes no banco de dados 
List<Anotacao> anotacoes = listarAnotacoes(); 


ArrayAdapter<Anotacao> adapter = 
new ArrayAdapter<Anotacao>(getActivity(), 
android.R.layout.simple list item 1, 
anotacoes) ; 


setListAdapter (adapter) ; 


O próximo passo é alterar a  AnotacaoActivity para implementar 


AnotacaoListener, deste modo 


public class AnotacaoActivity extends FragmentActivity 
implements AnotacaoListener { 


// códigos existentes 


@Override 
public void viagemSelecionada(Bundle bundle) { } 


@Override 
public void anotacaoSelecionada(Anotacao anotacao) {} 


@Override 
public void novaAnotacao() {} 


No método viagemSelecionada iremos verificar se o aplicativo está sendo 
executado em um tablet (ou outro dispositivo que possua uma tela maior) e com 
base nesta informação iremos ou recuperar o AnotacaoListFragment einvocar o 
seu método listarAnotacoesPorViage caso seja tablet, ou instanciar um novo 
AnotacaoListFragment e colocá-lo no lugar do FrameLayout caso seja um 


dispositivo com tela menor. 
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Obteremos um FragmentManager que será utilizado realizar operações sobre 
os Fragments, através do método getSupportFragmentManager. 

Caso um tablet esteja sendo utilizado, recuperamos o Fragment com a lista de 
anotações através do manager e na linha seguinte invocamos o método para listar 
anotações de uma determinada viagem e assim atualizar a lista de anotações exibidas 
pelo AnotacaoListFragment 

Caso não seja um tablet, criamos um novo AnotacaoListFragment, atri- 
buímos a ele um bundle e através de uma transaction substituímos o 
FrameLayout pelo Fragment recém-criado. Dessa forma, quando o usuário se- 
lecionar uma viagem haverá uma transição do ViagemListFragment para este 
novo Fragment que será exibido individualmente na tela. 


@Override 
public void viagemSelecionada(Bundle bundle) { 


FragmentManager manager = getSupportFragmentManager () ; 
AnotacaoListFragment fragment; 


if(tablet) { 
fragment = (AnotacaoListFragment) manager 
.findFragmentById(R.id.fragment_anotacoes) ; 
fragment .listarAnotacoesPorViagem(bundle) ; 


} else { 
fragment = new AnotacaoListFragment(); 
fragment .setArguments (bundle) ; 


manager .beginTransaction() 
.replace(R.id.fragment_unico, fragment) 
.addToBackStack (null) 
.commit(); 


Os outros dois métodos da %AnotacaoListener serão implementados de 
forma bastante similar ao que acabamos de fazer. A próxima 


implementação será para tratar a seleção de uma anotação, 





cujos detalhes devem ser exibidos no AnotacaoFragment . Na 
classe AnotacaoListFragment implementaremos o método onltemClick 
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para recuperar um objeto Anotacao da ListView e passá-lo como 
parâmetro para o método anotacaoSelecionada 


// novo atributo 
private AnotacaoListener callback; 


// códigos existentes 


@Override 

public void onAttach(Activity activity) { 
super.onAttach(activity) ; 
callback = (AnotacaoListener) activity; 


@Override 

public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 


Anotacao anotacao = (Anotacao) getListAdapter() .getItem(position) ; 
callback. anotacaoSelecionada(anotacao) ; 


Em vez de utilizar um Bundle, desta vez passamos o próprio objeto recuperado 
da lista como parâmetro para o método anotacaoSelecionada. É comum o 
uso das duas alternativas, cabe a você decidir, de acordo com a sua aplicação, qual a 
melhor estratégia a ser adotada. 

No AnotacaoFragment criamos dois métodos públicos, um para atribuir 
a anotação, que deve ser exibida pelo Fragment e outro para preparar a edi- 
ção de uma anotação selecionada da lista. Veja o código alterado da classe 


AnotacaoFragment: 


// Novo atributo 
private Anotacao anotacao; 


@Override 
public void onStart() { 


super.onStart(); 


dia = (EditText) getActivity().findViewById(R.id.dia); 
titulo = (EditText) getActivity().findViewById(R.id.titulo); 
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descricao = (EditText) getActivity().findViewById(R.id.descricao); 
botaoSalvar = (Button) getActivity().findViewById(R.id.salvar); 
botaoSalvar.setOnClickListener (this); 


if (anotacao != null) { 
prepararEdicao (anotacao); 


public void setAnotacao(Anotacao anotacao) { 


this.anotacao = anotacao; 


public void prepararEdicao(Anotacao anotacao) { 
setAnotacao(anotacao) ; 
dia.setText (anotacao. getDia() .toString()); 
titulo.setText (anotacao.getTitulo()); 
descricao.setText (anotacao.getDescricao()); 


Retornando para a  AnotacaoActivity, implementaremos o método 


anotacaoSelecionada da seguinte forma: 


@Override 
public void anotacaoSelecionada(Anotacao anotacao) { 
FragmentManager manager = getSupportFragmentManager () ; 


AnotacaoFragment fragment; 


if (tablet) 
fragment = (AnotacaoFragment) manager 
.findFragmentById(R.id.fragment_anotacao) ; 


fragment .prepararEdicao (anotacao); 


}else{ 
fragment = new AnotacaoFragment () ; 
fragment .setAnotacao(anotacao) ; 


manager . beginTransaction() 
.replace(R.id.fragment unico, fragment) 
.addToBackStack (null) 
.commit(); 
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A implementação é bem parecida com a realizada no método 
viagemSelecionada com a diferença apenas do Fragment utilizado e dos 
métodos invocados. Para implementar a regras associadas à criação de uma nova 
anotação também será bastante simples. Na AnotacaoListFragment precisamos 
implementar o método onClick que irá fazero callback sem informar nenhum 


parâmetro: 


OOverride 
public void onClick(View v) { 
callback.novaAnotacao() ; 


Criaremos um método públicoem AnotacaoFragment para ser invocado pela 
AnotacaoActivity quando o usuário escolher a opção de criar uma nova ano- 
tação. A função deste método é basicamente limpar quaisquer dados que estavam 


sendo exibidos previamente. Veja a sua implementação: 


public void criarNovaAnotacao() { 
anotacao = new Anotacao(); 
dia.setText(""); 
titulo.setText(""); 
descricao.setText(""); 


Na AnotacaoActivity, invocaremos o método criarNovaAnotacao caso 
seja um tablet que ja está exibindo todos os Fragments, ou criaremos um novo 
AnotacaoFragment sem informar uma anotação já que desejamos criar uma nova. 


Veja como fica a implementação do método novaAnotacao. 


@Override 

public void novaAnotacao() { 
FragmentManager manager = getSupportFragmentManager () ; 
AnotacaoFragment fragment; 


if(tablet) { 
fragment = (AnotacaoFragment) manager 
.findFragmentById(R.id.fragment_anotacao) ; 
fragment .criarNovaAnotacao() ; 
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} else { 
fragment = new AnotacaoFragment () ; 
manager . beginTransaction() 
.replace(R.id.fragment unico, fragment) 
.addToBackStack (null) 
.commit(); 


Pronto! Nossos Fragments já estão implementados e interagem entre si. Exe- 
cute a aplicação e confira o resultado! 


9.6 CARREGUE DADOS COM LOADERS 


Outro recurso muito útil inserido na versão 3 do Android e disponível no pacote 
de compatibilidade são os Loaders, que possuem a função de carregar dados de 
forma assíncrona em uma Activity ou Fragment. Outra característica é que 
um Loader pode monitorar uma fonte de dados, como um ContentProvider,e 
automaticamente disponibilizar os resultados assim que a informação é atualizada. 

O Android já disponibiliza o cursorLoader para carregar dados em 
cursores e, se necessário, podemos implementar o nosso próprio Loader es- 
tendendo de AsyncTaskLoader para carregar assincronamente outros tipos de 
recurso. 

Nesta seção faremos uma implementação de exemplo para explorar este recurso, 
utilizando o ContentProvider que já criamos para carregar a lista de viagens 
através de um CursorLoader. A classe LoaderManager é a responsável por 
gerenciar um ou mais Loaders em uma Activity ou Fragment. As operações 
devem ser realizadas através de callbacks. Para isto, é necessário implementar a 
interface LoaderCallbacks. Veja o código abaixo: 


public class ViagemListFragment extends ListFragment 
implements OnItemClickListener, 
LoaderCallbacks<Cursor> { 
// códigos existentes 


@Override 
public void onActivityCreated(Bundle savedInstanceState) { 


super .onActivityCreated(savedInstanceState) ; 
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getLoaderManager () .initLoader (0, null, this); 


Override 
public Loader<Cursor> onCreateLoader(int id, Bundle args) { } 


@Override 
public void onLoadFinished(Loader<Cursor> loader, Cursor data) { } 


@Override 
public void onLoaderReset (Loader<Cursor> loader) { } 


Para implementar LoaderCallbacks, incluímos o método 
onCreateLoader, que é utilizado para criar um novo Loader, O 
onLoadFinished e o onLoaderReset, que são chamados, respectivamente, 
quando um Loader terminou de ser carregado e quando foi resetado. 

No método onActivityCreated, invocado quando a atividade que contém 
o Fragment é criada, recuperamos um LoaderManager e fazemos a inicialização 
de um Loader através do método initLoader. O primeiro parâmetro que este 
método recebe é um número que identifica o Loader que se deseja carregar. No 
segundo, podemos passar um Bundle com dados necessários para sua construção, 
e o terceiro argumento é a implementação do callback que neste caso é o próprio 
Fragment. 

No método onCreateLoader devemos instanciar e retornar o Loader que 
será utilizado. No nosso caso utilizaremos um CursorLoader para carregar as- 
sincronamente as viagens obtidas do nosso ContentProvider. A implementação 
deste método é a seguinte: 


@Override 
public Loader<Cursor> onCreateLoader(int id, Bundle args) { 
Uri uri = Viagem.CONTENT URI; 
String[] projection = new String[]{ Viagem._ID, Viagem.DESTINO }; 
return new CursorLoader(getActivity(), 
uri, projection, null, null, null); 


Por enquanto só estamos carregando os dados e ainda não os colocamos na 
ListView. O próximo passo é alterar a implementação do método onStart para 
utilizar um CursorAdapter, veja: 
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// novo atributo 
private SimpleCursorAdapter adapter; 


@Override 
public void onStart() { 
super .onStart (); 
adapter = new SimpleCursorAdapter (getActivity(), 
android.R.layout.simple list item 1, null, 
new String[] { Viagem.DESTINO }, 
new int[] { android.R.id.texti }, 0); 
setListAdapter (adapter) ; 
getListView() .setOnItemClickListener (this) ; 


Quando o carregamento dos dados for finalizado, no método 
onLoaderFinished devemos alterar o cursor utilizado pelo CursorAdapter 
para exibir os dados recuperados. Da mesma forma, devemos alterá-lo quando o 
Loader for reiniciado. Veja como ficam essas implementações: 


@Override 
public void onLoadFinished(Loader<Cursor> loader, Cursor data) { 
adapter. swapCursor (data); 


@Override 
public void onLoaderReset (Loader<Cursor> loader) { 
adapter. swapCursor (null); 


A última alteração necessária é modificar a implementação do onItemClick 
para recuperar o id do item selecionado na lista de viagens. Este id será utilizado 
posteriormente para carregar as anotações associadas com a viagem selecionada. As 


alterações são as seguintes: 


@Override 
public void onItemClick(AdapterView<?> parent, 
View view, int position, 
long id) { 
long viagem = getListAdapter() .getItemId(position) ; 
Bundle bundle = new Bundle(); 
bundle.putLong(Constantes.VIAGEM SELECIONADA, viagem); 
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callback.viagemSelecionada(bundle) ; 


} 


Agora ao executar a aplicação, teremos o Loader carregando os dados para 
alimentar a lista de viagens. Experimente! 


9.7 CONCLUSÃO 


Neste capítulo vimos como projetar nosso aplicativo para que ele seja compatível 
com tablets e outros dispositivos, com diversos tamanhos de tela e diferentes versões 
de Android. 

Acrescentamos mais uma funcionalidade ao aplicativo BoaViagem que utiliza 
os recursos da API de Fragments para prover uma interação e layout diferenciados 
para o uso em um tablet. Por fim, exercitamos a utilização de Loaders para carregar 
dados de forma assíncrona. 
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CAPÍTULO 10 


Publicação no Google Play 


Chegou a hora de publicar a sua app para o mundo! Para realizar o registro como 
desenvolvedor no Google Play, você irá precisar de uma conta do Google e de um 
cartão de crédito internacional para realizar o pagamento da taxa de U$ 25,00. O 
processo é simples e serve tanto para pessoa física como para empresas. Veja a seguir 
como criar a sua conta e realizar a publicação de uma app. 


10.1 PREPARE A APLICAÇÃO 


Antes de mais nada, é necessário preparar a sua aplicação para que ela possa ser pu- 
blicada e posteriormente atualizada no Google Play. Os primeiros itens que devemos 
conferir é no AndroidManifest.xml: 


<?xml version="1.0" encoding="utf-8"?> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="br.com. casadocodigo.boaviagem" 
android: versionCode="1" 
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android:versionName="1.0" > 
<!-- demais itens --> 


O nome do pacote, especificado no atributo package (linha 3) deve ser único 
para identificar a sua aplicação no Google Play, por isso é comum utilizar algo seme- 
lhante a um domínio de Internet. Uma vez publicada, não será mais possível alterar 
este nome de pacote. O atributo versionCode é outro atributo importante que 
identifica a versão atual da aplicação. Este atributo é utilizado para verificar se há 
atualizações a serem realizadas no aplicativo. 

A cada nova versão esse número deve ser incrementado. Já o atributo 
versionName (linha 4) é de uso livre para o desenvolvedor nomear a versão da 
forma que quiser. Este atributo é exibido no Google Play e também no próprio dis- 
positivo enquanto que o versionCode (linha 5) é invisível para o usuário. 

Dando continuidade à preparação, o Android exige que todos os aplicativos se- 
jam assinados digitalmente como uma forma de identificar o autor da aplicação. Du- 
rante o desenvolvimento, o plugin ADT já cuida da geração e assinatura do apk sem 
termos que nos preocupar. Para a publicação no Google Play criaremos um certifi- 
cado digital autoassinado para realizar a assinatura do apk. 

Para que as atualizações do aplicativo possam ser aplicadas de forma transpa- 
rente para o usuário, é importante sempre assinar a aplicação com o mesmo certi- 
ficado. Quando o Android atualiza um aplicativo, é verificado se os certificados da 
versão nova coincidem com aqueles da versão instalada. Se forem idênticos, então 
a atualização é realizada. Caso contrário, não será possível realizar a atualização. A 


seguir, veja como exportar, gerar o certificado e assinar o apk para publicação. 
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ana Export 


Select an export destination- 





2 filer text 


P @& General 
¥ (> Android 


b ( Install 

> Java 

+ E Run/Debug 
> (Tasks 

+ Team 

P XML 

+ (© Other 








[ Next> | [Cancel | 





Figura 10.1: Exportação 


Como mostra a figura 10.1, acesse o menu File -> Export e escolha a opção 
Export Android Application. Depois informe o projeto desejado (imagem 
10.2). Na tela seguinte, mostrada na imagem 10.3, selecione a opção Create new 
keystore, pois é a primeira vez que estamos realizando esse processo. Na próxima 
exportação, você poderá escolher a opção de utilizar um keystore existente. In- 
forme uma senha segura e sua confirmação. 
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Project Checks 
Performs a set of checks to make sure the application can be exported. 





Select the project to export: 


a [1 


No errors found. Click Next. 





Finish 





Figura 10.2: Exportação 
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aaa Export. Android Application 
Keystore selection 








| + Use existing keystore 


W Create new keystore 





Location: /Users/joao/Documents/keystore | “Browse... 





Password: seeese 


Confirm: emesea | 





Finisty 





Figura 10.3: Exportação 


Na próxima tela, ilustrada na figura 10.4, informaremos os dados da chave. É 
recomendado que a validade do certificado seja superior a 25 anos. Informe nova- 


mente uma senha segura, um alias e a identificação do autor da aplicação. Os 
demais campos são opcionais. 
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Key Creation 








Alias: boaviagem 





Password: ...... 





Confirm: s.s... 





Validity (years): 100 








First and Last Name: Livro de Android 





Organizational Unit: 





Organization: 





City or Locality- 





State or Province: 





Country Code (XX): 





[<Back | Nee) | cane | Finish 





Figura 10.4: Exportação 


Para finalizar a exportação, na próxima tela selecione o local de destino do ar- 
quivo apk assinado e clique em Finish, como mostra a figura 10.5. 


Agora a sua aplicação está pronta para ser publicada! 


294 


Casa do Código Capítulo 10 


. Publicação no Google Play 








Destination and key /certificate checks 








Destination APK file: | / Users /joao /BoaViagem.apk 


Certificate expires in LOO years. 





Figura 10.5: Exportação 
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10.2 CRIE UMA CONTA DE DESENVOLVEDOR 


ef 
MAA | Aocoste accounts 





e ©) B heps://accounts.google.com/ServiceLagin?service=androiddeveloper&passive=true&nui=1&continue=htps://play.y.. We & A 


Google 





Google Play Android Developer Console 
Distribute your applications to users of Android mobile phones. Signin 


Google Play Android Developer Console enables developers to easily publish and distribute Ewe 


their applications directly to users of Android-compatible phones. 


D Come one. Come all 
Google Play Android Developer Console is open to all Android application 


developers. Once registered, developers have complete control over when and how 
they make their applications available to users, 


Sunn + Stay signed in 
Easy and simple to use 


Start using Google Play Android Developer Console In 3 easy steps: register, 
upload, and publish 














Cant access your account? 


Great visibility 

Developers can easily manage their application portfolio where they can view 
information about downloads, ratings and comments. Developers can also easily 
publish updates and new versions of their apps 

To learn more about how to use Google Play Android Developer Console, visit the 
Google Play Android Developer Console help center. 


Terms of Service Privacy Policy Help 





Figura 10.6: Android Developer Console 


Acesse o site https://play.google.com/apps/publish/ e faça o login utilizando a sua 
conta Google (imagem 10.6). Uma tela semelhante à exibida na imagem 10.7 será 
apresentada para o preenchimento dos dados básicos. 
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5 Inscrição do desenvolvedor = 


e 3e hrtps://play.google.com /apps /publish/signup 




















livratteandroid@amailcom | Pasvys inicial | Avis | Android com | Sar 





be Google play | ANDROID DEVELOPER CONSOLE 


Primeiros passos 
Antes de publicar um software no Google Play, você deve fazer três coisas: 
* Criar um perfil de desenvolvedor 


+ Concorde com o 
* Pagar uma taxa de registro ( US$25,00) com cartão de crédito (usando o Google Checkout) 


Detalhes da entrada 


Seu perfil de desenvolvedor determinará como você aparece para os clientes do Google Play 


Nome do desenvolvedor 


Aparecerá para os usuários embaixo do nome do seu aplicativo 
Endereço de e-mail Tivrodeandroidíagmail 


URL do site “http: / /www.livrodeani 


Número de telefone [16502530000 | 16502530000 


Inclua o sinal de adição, o código do pais e o código de area. Por exemplo, + 1-650-253-0000. Por que 


Atualizações por e-mail CI Entrar em contato comigo ocasionalmente sobre desenvolvimento e oportunidades do Google Play. 


Figura 10.7: Informações básicas 


Em seguida, aceite o contrato de distribuição como ilustra a figura 10.8 
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y * 5 Inscrição do desenvolvedor = 


€ > Œ D https://play.google.com/apps /publish/signup 


=. == 

















liventteandroid@amailcam 





Be Google play | ANDROID DEVELOPER CONSOLE 


Leie concorde com o Contretn de distribuiçao do desenvolvedor 


Os termos e as condições variam de acordo com o pais no qual seu endereço de faturamento está localizado, 
Escolha seu país de faturamento abaixo para visualizar os termos e condições adequados 


NIRO! 





Contrato de distribuição do desenvolvedor do Android Market 


Definições 


Google: Google Inc., uma empresa do estado de Delaware sediada no endereço 1600 Amphitheatre Parkway, Mountain 
View, Califómia, 94043, Estados Unidos. 


Dispositivo: qualquer dispositivo que pode acessar o Android Market, conforme definido neste documento. 
Produtos: software, conteúdo e materiais digitais distribuídos no Android Market. 


Market: o mercado criado e operado pelo Google que permite que Desenvolvedores registrados em determinados países 
possam distribuir Produtos diretamente aos usuários dos Dispositivos. 


Desenvolvedor ou você: qualquer pessoa ou empresa que esteja cadastrada no Market e tenha licença para distribuir 
produtos de acordo com os termos do presente contrato. 


Conta de desenvolvedor: conta para publicação fornecida aos desenvolvedores, que permite a distribuição de produtos 
através do Market. 


Processadores de pagamento: qualquer parte autorizada pelo Google a fomecer serviços de processamento de pagamento 
nus nermitam aue ns desenvolvedores cam contas de nagamento nocionais cobrem ns tisuários dos disonsitivos pelos. 


M Concordo e estou disposto a associar o registro de minha conta ao Contrato de distribuição do desenvolvedor. 


Figura 10.8: Contrato de distribuição 


Em seguida, é necessário realizar o pagamento da taxa com um cartão de crédito 
internacional utilizando o serviço Google Wallet, como mostram as imagens 10.9 e 
10.10. 
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€ — Œ Ø hups://play.google.com/apps /publish/signup 





























livrodeandroid@amail.com | Página inicial | Ajuda | Android com | Sar 





he Google play | ANDROID DEVELOPER CONSOLE 


Registrar-se como um desenvalvecor 


Taxa de registro: US$25,00 


Sua taxa de registro permite que você publique softwares no Market. O nome e o endereço de cobrança usados para o registro 
serão associados ao Contrato de distribuição do desenvolvedor. Por isso, confira tudo com atenção! 


Pague sua taxa de registro com 


W Google 


E 2012 Google - Termos de Serviço do Google Play - Politica de Privacidade 





Figura 10.9: Pagamento da taxa 
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= 2 
eono M Google wallet x 





e C | E hrps://accounts.google.com/ServiceLogin?service=sierra&continue=hrtps: | /checkout.google.com/view/buy?o%3 





Pesquisar Imagens Mar Pla 


3) Google wallet 


Revisar pedido - Google 


TDE ITEM mito 


t Android 


US$ 25,00 
Developer Registration Fee for livrodeandroid@gmail com 


Faça login para calcular imposto e envio. 


Subtotal: US$ 25,00 


@ Faca compras com segurança com a Carteira virtual do Google - Obtenha 100% de proteção contra compras não autorizadas enquanto fizer compras 
nas lojas da web 


Não tem uma Conta do Google? 


Adicione um cartão de crédito à sua 
Conta do Google 


E-mail 
livrodeandroid@gmail.com 
Local 


Brasil 





Figura 10.10: Pagamento da taxa 


Após o pagamento ter sido realizado com sucesso, você terá acesso ao console 
do desenvolvedor, mostrado na imagem 10.11. 
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© OO Y console do desenvolvedor 




















CG & hrps://play.google.com/apps /publish/Home?dev acc=10929085545021936172 





João Bosco Monteiro joaobmonteirofbgmail.com | Página 





b Google play | ANDROID DEVELOPER CONSOLE 


Seu registro como desenvolvedor do Google Play foi aprovado! 
Agora, você pode enviar e publicar software no Google Play. 


João Bosco Monteiro 


joaobmonteiro@gmail.com 
Editar perfil» Gerenciar contas do usuario » 





Todas as listagens de aplicativos do Google Play 


Nenhum aplicativo enviado 


[+] Enviar aplicativo 


Google checkout Œ 


Deseja vender aplicativos e produtos em aplicativos? 

Defina uma Conta de comerciante no Google Checkout. Será necessário inserir informações adicionais como informações 
da sua conta bancária e ID de contribuinte 

Abrir Conta de comerciante » 








© 2012 Google - Termos de Serviço do Google Play - Politica de Privacidade 





Figura 10.11: Android Developer Console 


Caso a sua aplicação não seja gratuita, será necessário criar uma conta de comer- 
ciante (Merchant Account) para que você possa receber os valores das vendas. Para 
criar este tipo de conta, utilize a opção disponível no próprio site Android Developer 
Console e preencha as informações necessárias. 


10.3 REALIZE A PUBLICAÇÃO 


Para publicar a sua aplicação, no console do desenvolvedor (imagem 10.11) esco- 
lha a opção Enviar aplicativo. Uma tela será aberta para a realização do upload 
do arquivo .apk que foi previamente preparado, conforme mostra a imagem 10.12. 
Depois disso, será necessário preencher informações adicionais sobre o aplicativo, 
incluindo o ícone em alta resolução, capturas de tela, imagens e textos de divulgação 
e a descrição do que a aplicação faz (imagem 10.13). Seja caprichoso na produção 
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destes itens pois eles serão o primeiro contato com o usuário. 




















Fazer upload do novo APK 


Requerido: selecione o APK de seu aplicativo 
Choose File | No file chosen [ Enviar | 


Se seu aplicativo exceder o limite de APK de 50 MB, você pode adicionar arquivos de 


| Opcional: adicionar um arquivo de expansão 
| expansão. 


| Adicionar arquivo | 





Figura 10.12: Upload do .apk 
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sao | 5 Console do desenvolvedor 


g = Cia https: / /play.google.com /apps /publish/HomeZdev acc=10929085545021936172%AppEditorPlare p 











Editar aplicativo 


Publicar 


Detalhes do produto | Amulvos APK 


Enviar recursos 


Capturas de tela Adicionar uma captura de tela. Capturas de tela: 
pelo menos duas | Choose File | No file chosen 320 x 480, 480 x 800, 480x854. 
‘—- 1.280x720, 1.280x800 

24 bits no formato PNG ou JPEG 
(sem alfa) 
Sem margens nem bordas 
È possivel fazer upload das capturas 
de tela em orientação paisagem. As 
miniaturas parecerão invertidas. 
porém, as Imagens reais e suas 
orientações serão preservadas. 


Ícone do aplicativo em alta Ícone do aplicativo em alta 
resolução | ChooseFile | No file chosen resolução: 
Saiba mais pesada ei “PES ‘BIAwHI2 
PNG ou JPEG de 32 bits 
Máximo: 1024 Kb 


Gráfico promocional Adicionar gráfico promocional Gráfico promocional: 
opcional [ Choose File | No file chosen 180 L x 120 A . 
PNG ou JPEG de 24 bits (sem alfa) 
Sem bordas na arte 


Gráfico de recursos Adicionar gráfico de recursos; Gráfico de recursos: 
opcional | Choose File | No file chosen 1024 x 500 
eal ~~~ PNG ou JPEG de 24 bits (sem alpha) 
Sera diminuído para tamanho mini ou 
micro 


Video promocional Adicionar link de vídeo promocional. Video promocional: 
opcional http:// Insira o URL do YouTube 





Politica de Privacidade Adicionar link de política de privacidade: 





Figura 10.13: Informações adicionais 


Outros dados também devem ser informados, siga as orientações contidas na 
própria página para o seu correto preenchimento. 


Pronto! Agora é só clicar em publicar e aguardar o processo de publicação que 
geralmente leva poucas horas para ser concluído. 
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CAPÍTULO 11 


Continue os estudos 


Ufa! Depois de uma longa e boa jornada chegamos ao final do nosso livro. Criamos 
uma aplicação cheia de funcionalidades interessantes que poderão servir de base ou 
inspiração para que você desenvolva seus projetos. 

No entanto, é importante saber que seus estudos não podem parar por aqui. 
Existe muito material bom mundo afora, sendo que a primeira fonte que você deve 
sempre ir buscar por informações é na página oficial do Android, http://developer. 
android.com. 

Fique atento e acompanhe o lançamento das novas versões do Android que sem- 
pre vêm com novidades, não só para o usuário final como também para o desenvol- 
vedor. Diversos guias mostrando como funcionam os novos recursos são publicados 
na página oficial. Existem também muitos livros bons, como o Android in Action, 
do W. Frank Ableson, Robi Sen, Chris King e C. Enrique Ortiz. 

Crie também o hábito de investigar o código fonte do Android, pois ele é sem- 
pre uma boa referência de implementação e descobertas: http://source.android.com. 
Outro ponto importante é conhecer e aplicar as guidelines de design recomendados 


Casa do Código 





pelo Google em https://developer.android.com/design/. Valorize a experiência do 


usuário pois ela é um ponto chave para o sucesso da sua aplicação. 


Além disso, preocupe-se com a qualidade do código produzido e utilize ferra- 


mentas e frameworks para auxiliá-lo em tarefas corriqueiras. Alguns exemplos de 


frameworks que podem ajudar são: 


ORM Lite - http://ormlite.com - ferramenta para mapeamento objeto- 
relacional compatível com Android. 


Android Query - http://code.google.com/p/android-query/ - biblioteca com 
funções utilitárias para requisições e tarefas assíncronas, manipulação de 
views e outras utilidades. 


Android Annotations - http://androidannotations.org/ - framework que re- 
solve situações recorrentes como binding de views, recursos do sistema e 
criação de listeners. 


Spring Android - http://www.springsource.org/spring-android - framework 
que oferece facilidades para comunicação com serviços REST e autenticação 
OAuth. 


Por fim, espero que você tenha muito sucesso nas suas aplicações Android e que 


continue aperfeiçoando seus conhecimentos! 
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